home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Bible Heaven
/
Bible Heaven.iso
/
elftree
/
elftree.hlp
< prev
next >
Wrap
Text File
|
1994-02-15
|
172KB
|
4,060 lines
ELFTREE (TM)
(C) Copyright 1988-1994 By Alan J. Avery
This program was written by:
Alan J. Avery
1408 Noble Avenue
Springfield, Illinois 62704
(217)-698-8600 (8 a.m. to 9 p.m. CDT please!)
(217)-698-8601 (FAX - 24 hours a day)
────────────────────────────────────────
Register For Support, Updates
To get support for this product and notices of updates, you must
register. See the user manual for the registration form.
────────────────────────────────────────
DISCLAIMER
The Author specifically disclaims all other warranties, expressed or
implied, including but not limited to, implied warranties of
merchantability and fitness for a particular purpose with respect to
defects in the diskette and documentation, and the program license
granted herein. In particular, and without limiting operation of the
program license with respect to any particular application, use, or
purpose, in no event shall the Author be liable for any loss of profit
or any other commercial damage, including but not limited to special,
incidental, consequential or other damages. Your use of this program
constitutes acceptance of these terms.
────────────────────────────────────────
Introduction
ELFTREE is designed to simplify your goal of getting the most out of
your computer. The heart of the program is a marvelously powerful
file and directory manager. With it, you can install software in
record time, move files from one spot to another (even across a
network!) with ease, and work with files on even the largest hard
disk as if they were in one directory!
ELFTREE works with DOS, 4DOS, or any other computer environment that
simulates DOS, such as network operating systems or DOS emulators on
a Macintosh computer. You won't believe how easy it is to run a
program from within ELFTREE, or to customize the colors displayed.
You will see in all of ELFTREE's features that great care was taken
to marry tremendous power with extreme convenience. The result is a
delightful product that will help to make you much more effective.
Thousands of ELFTREE users have contributed countless suggestions
toward its development over the past 6 years, and most of these have
been incorporated. To all of them, THANK YOU!! Your insights and
ideas have been a delight to implement, and I look forward to more
coding adventures.
────────────────────────────────────────
What Makes ELFTREE Unique?
1. Deceptively Simple - It LOOKS like a ho-hum `shell' program, but
its features are rich enough to stretch the talents of any
computer professional and simple enough to calm novice users.
Designed for easy use with keyboard or mouse.
2. Powerful/Friendly - Gather files (using multiple criteria) from
hundreds of directories on many disks, and work with them
as if they were in one place! Attach notes to files in
any directory (ELFTREE can read/write 4DOS notes directly).
Customize it from inside! Format disks in the middle of
copying files! Copy files to multiple directories! Clear
a subtree of files, or remove it from your disk! Load TSRs
from a menu! Use any video mode with at least 25 lines and
80 columns (selects EGA/VGA modes, too)! Lots more!
3. Trim - ELFTREE can run programs with NO overhead! Any program
that runs from the DOS prompt can be run from ELFTREE!
4. Thoughtful - Rename a directory and the directory tree is sorted
automatically. Remove the current directory and you move
to its parent. Try to enter a directory that does not
exist, and the tree will be pruned. Display the tree from
a newly created directory, and it is added automatically.
5. FAST - Responds instantly to commands! Most commands require
tapping only one key (for example, [C] for Copy), and all
of the speed-intensive operations are coded in optimized
Assembler for the absolute maximum speed!
6. Flexible Capacity - You can specify how much memory ELFTREE uses
to manage files, directories, notes, etc.!
7. View Files - The internal viewer can view any type of file through
several filters (or in Hex). Scroll the file automatically at
any of 9 different speeds. Search forward or backward through
the file for text. Advanced block operations are available.
EBCDIC files can be viewed as ASCII (or vice versa).
8. Editor - ELFTREE's editor can edit multiple files as large as
available memory. The editor is packed with needed features:
Column block operations, Normal block operations, 11 stored
keyboard macros, FAST search and replace, etc.
────────────────────────────────────────
Unusually Activated Features
When you highlight a file with an extension of EXE, COM, BAT or BTM
in the file information window and tap [F3], ELFTREE will `preload'
the name of that file in the command line that appears. To run the
program, you simply tap [Enter]. Alternatively, if you set ELFTREE
for Mode: Immediate instead of Mode: Delay, you can skip the [F3]
entirely, and just tap [Enter] to run the program.
You can train ELFTREE to be sensitive in another way. Say you want
to load your word processor when the highlighted file has a DOC
extension, or your spreadsheet when the extension is WK1. When
ELFTREE is prepared appropriately, just tap [Enter] and the program
is launched with that file loaded. Similarly, if you have programs
that are designed to view certain types of files, you can train
ELFTREE to load the viewer you want by simply tapping [V] once
the file is highlighted.
Finally, if you have an EGA or VGA (ELFTREE will detect it), you
can vary the number of lines displayed on the screen by tapping
[Ctrl+V] (think of the V as in VIDEO).
────────────────────────────────────────
Enjoy!
Active Keys In ELFTREE
The choice of keys used in ELFTREE is designed with your convenience
in mind and, with practice, will quickly become familiar. Here is a
list of them, and a description of each:
Part I - The Elvish Touch
Part II - The Mouse Toolbar
Part III - File Information Screen Only
Part IV - Directory Information Screen Only
Part V - Editing Keys
────────────────────────────────────────
Part I - The Elvish Touch
────────────────────────────────────────
Elvish Consulting is proud to introduce The Elvish Touch, which lets
you use any feature of ELFTREE without needing more than one finger!
(Incidentally, this will NOT interfere with any keyboard handlers
you may be using.)
For example, suppose you want to locate a file that starts with `E'.
In ELFTREE, the keystroke [Alt+E] performs this action, and normally
requires you to hold down the [Alt] key and then tap the [E] key.
If you use The Elvish Touch, you can also select this by tapping
[Alt], and then tapping [E]. Such convenience!
────────────────────────────────────────
Activating The Elvish Touch
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
To activate (or deactivate) The Elvish Touch:
1. Tap [F4] to bring up the Customize menu.
2. Tap [F] to select the Switches submenu.
3. Tap [B] to toggle the current setting.
────────────────────────────────────────
ALT and CTRL LOCK
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
ELFTREE offers a way to `lock' the [Alt] and [Ctrl] keys. For
example, to lock the [Alt] key, you tap it twice, and an `A' will
appear in the lower right corner of your screen, signifying that
[Alt] is in a locked state. While [Alt] is locked, any key that
can be affected by [Alt] is. Thus, [E] becomes [Alt+E], [F1]
becomes [Alt+F1], etc. To `unlock' [Alt], tap [Alt] or [Ctrl] once,
and the `A' will disappear. Also, if [Alt] is locked, you can lock
[Ctrl] by just tapping it twice. When [Ctrl] is locked, a `C' will
appear in the lower right corner of your screen, and any keys that
can be modified are, so [E] becomes [Ctrl+E], etc.
It is not possible to lock both [Alt] and [Ctrl] at the same time.
This `locking' feature is always available, regardless of whether
you have `The Elvish Touch' enabled.
────────────────────────────────────────
Part II - The Mouse Toolbar
────────────────────────────────────────
If a mouse driver is detected and ELFTREE is allowed to use a mouse
(see Customize Key/Mouse Settings menu), a toolbar displaying
mouse function symbols appears. Here is what each symbol represents:
Esc Escape key.
Help F1 key.
Up Up arrow (repeats).
Down Down arrow (repeats).
Left Left arrow (repeats).
Right Right arrow (repeats).
<< Page Backward (repeats).
>> Page Forward (repeats).
╝ Enter or Return key.
Del Delete key.
F2 F2 key.
F3 F3 key.
F4 F4 key.
F5 F5 key.
F6 F6 key.
F8 F8 key.
F9 F9 key.
F10 F10 key.
F11 F11 key.
F12 F12 key.
Menu Brings up MENU.ETU (attached to U or middle mouse button)
Exit Exits ELFTREE immediately (same as [Ctrl+Break]).
The mouse toolbar is available any time it is visible in ELFTREE.
The user menu in MENU.ETU will only appear from the file screen.
────────────────────────────────────────
Part III - File Information Screen Only
────────────────────────────────────────
MOUSE FUNCTIONS
Menu Bar Click on a menu selection to activate it. For example, click
on Rename to activate it.
Description Double-click to activate help for the highlighted menu item.
Drive List Click on a drive letter to change drives.
Current Path Click on Drive portion to change drives, click on path
portion to show directory tree.
? - Help Click to bring up help screens of what keys are active.
Click on a key to simulate tapping it.
File Headings Click to cycle forward to next file layout.
File Listing Left-click to highlight a file or directory, right-click to
tag or untag a file, double-click to simulate tapping [Enter]
for this item. Click and hold down a mouse button to move
selection bar to another file or directory (files will be
tagged or untagged if the right mouse button is held down).
If clicked and held on the first or last file in the list,
the file display will scroll backward or forward,
respectively. If the right button is clicked and held, the
files will be tagged/untagged as they are scrolled.
Left Edge Click on left edge of screen to simulate [Left] key.
Right Edge Click on right edge of screen to simulate [Right] key.
Shrink: Click to toggle between 2K and 0K.
Mode: Click to toggle between Immediate and Delay modes.
Miscellaneous If a box appears on the screen, clicking inside the box (but
not on any 'hot spot') usually does the same action as
tapping [Enter]. Clicking outside the box (but not on the
mouse toolbar) usually does the same as tapping [Esc] to
cancel an action. One exception to this is the DOS Gateway
box, where if you click on a file name, that name is added
to the command line.
───────────────────────────────────────────────────
CURSOR KEYS
[Right] Highlights the next choice on the moving-bar menu on the
top row, if not in a multicolumn format.
[Left] Highlights the previous choice on the moving-bar menu on
the top row, if not in a multicolumn format.
[Up] Highlights the previous item in the file information area.
[Down] Highlights the next item in the file information area.
───────────────────────────────────────────────────
TAB, HOME, END, PGUP, PGDN, Ctrl+PGUP, Ctrl+PGDN
[TAB] Advance to the next file display format setting. The
possible selections show 1, 2, or 5 files per row or
one file-note pair per row.
[Shift+TAB] Back to the previous file display format setting. The
possible selections show 1, 2, or 5 files per row or
one file-note pair per row.
[Home] Highlights the first item in the file information area, if
in 1-column mode. In multi-column mode, its function
depends on how many times you tap it without using any
other key. Tap it once, and the highlight moves to the
top of the current column. Tap it again, and the
highlight moves to the top of the first column. Tap it
a third time (or more) and the highlight moves to the
first item in the file information area.
[End] Highlights the last item in the file information area, if
in 1-column mode. In multi-column mode, its function
depends on how many times you tap it without using any
other key. Tap it once, and the highlight moves to the
bottom of the current column. Tap it again, and the
highlight moves to the bottom of the last column. Tap
it a third time (or more) and the highlight moves to the
last item in the file information area.
[Ctrl+PgDn] Moves the highlight to the last item.
[Ctrl+PgUp] Moves the highlight to the first item.
[PgDn] Moves the highlight to the last item on the screen, then
on to the next screen, if any.
[PgUp] Moves the highlight to the first item on the screen, then
back to the previous screen, if any.
────────────────────────────────────────
MISCELLANEOUS KEYS
[Space] Tags/untags the current file, highlights the next.
[Enter] Selects the item highlighted on the moving-bar menu
bar menu on the top of the screen, if in Delay mode.
In Immediate mode, this executes the highlighted
program (or program associated with it), if possible,
enters the directory (if a directory), or selects
the menu command, if none of these apply.
[Ctrl+Enter] Selects the highlighted item on the moving-bar menu.
[Esc] Cancels current operation; exits if none are pending.
[ + or - ] Moves to the next or previous directory.
[ > or < ] Moves to the next or previous tagged file.
[=] Searches for a file name as you type it.
["] Duplicates the highlighted file.
[&] Combines two or more tagged files into one.
[*] Marks a block of files to be tagged. To use it, move to the
first file in the block, tap [*], then move to the last file
in the block and tap [*] again. All of the files between the
first and last ones will then be tagged.
[\] If working with files from more than 1 directory, this
jumps to the directory of the highlighted file (and
keeps it highlighted). If working with files in just
1 directory, this rereads the current directory, and
keeps the same file highlighted.
[%] Toggles whether the percentage of slack space for the
displayed files should be shown. See the Help section
on Sorting files for a description of slack space.
[,] Tap this TWICE to cycle among the various characters
used to separate thousands in large numbers.
[;] Tap this TWICE to cycle through the various time formats.
The selections are:
HH:MM am HH:MM:SS (24-hour) HH:MM:SSa (12 hour)
────────────────────────────────────────
A through Z
Menu Commands for File Display
(Note: Tap the first character of a command to activate it.)
[T] TAG - To work on a group of files, you `tag' them. To tag the
[Space] highlighted file, tap [Space] once and a '' will appear to the left
of the name. To clear the tag, tap [Space] again. More tagging
options can be found under the Tag command. (There is no need to
tag an individual file to work with it.)
[A] ATTRIBUTES - You can change file and directory attributes quickly.
For example, you will want to make some of your important files
read-only so that they can't be erased `accidentally'. Also, you
will probably want to hide some of the personal files on your office
computer so that a casual snoop won't know they're around. (If you
have DOS 3.0 or later, you can run hidden programs!)
[C] COPY - You can quickly copy files to another directory or disk.
[D] DIRTREE - Display the directories on the current disk as a tree,
with the directories in alphabetical order. You can move along this
tree to another directory with the cursor keys. You can also create
a new directory (N), delete an entire branch of directories, change
to a different disk (F6 or L), rebuild the tree (S) find a directory
by name (F or =), tag them (Space or T), or hide (H), copy (C),
move (M) or graft (G) them.
[E] EDIT - You can call up an editor (or word processor) to work on one
on one or more files by tagging them and tapping [E]. ELFTREE's
editor (available with purchase of ELFTREE) is very helpful.
[F] FIND - Lets you gather and manage files from across many directories
and disks (even networked drives) as if they were in one place!
[M] MOVE - Relocate files to another directory or disk.
[N] NOTE - Attach, edit, erase or find notes about files. If you use 4DOS
or ProFinder, ELFTREE can read/write their notes directly.
[P] PRINT - Print files, or a listing of file names, sizes, notes, etc.
[R] RENAME - Renames a file or directory.
[S] SPACE - Show space utilitization for all disks, levels of base, EMS
or XMS memory, and space allotment for tagged files.
[V] VIEW - Browse the contents of files through any of several filters.
Any file on your disk can be viewed from ELFTREE. You can search
for text, adjust expansion of tabs, print or save portions of the
file, or convert portions to upper, lower or proper case. External
viewers can be associated by file extension.
Off-menu commands:
[B] Toggles whether file column borders are shown.
[L] Change to the current directory on another disk, or read the same
directory (same as [F6] or [Shift+disk]).
[O] Shells immediately to DOS.
[U] Activates a menu file called MENU.ETU.
[Y] Tap this TWICE to change the date format. The selections are:
MM/DD/YY YY/MM/DD DD/MM/YY
Mon-DD-YY YY-Mon-DD DD-Mon-YY
────────────────────────────────────────
ALT KEYS
[Alt+Key] Search for an item whose first letter matches `Key'. For
ex, [Alt+A] looks for the next item that starts with `A'.
────────────────────────────────────────
FUNCTION KEYS
[F1] Activates the Help system.
[F2] Selects sort criteria for file area information.
(See [F5] below for further rearranging.)
[X] or [F3] Opens the DOS Gateway for entering a DOS command or program
to run, or to shell to DOS (use EXIT to return).
[F4] Activates customization menu. Change screen colors, name
of the editor or format program to use, the speed or delay
of the keyboard, or dozens of other settings. TRY IT!!!!!
[Ctrl+F4] Toggles between Immediate and Delay modes. (same as [I])
[F5] Helps rearrange the order of items in the file information
area to something not achievable via the Sort facility alone.
This makes it easy to print files in a certain order.
[L] or [F6] Change to the current directory on another disk, or reread
or [Shift+disk] the current directory if the same disk is selected.
[Ctrl+F6] Displays a table of ASCII characters.
[DEL], [F7] Erase a file or, if the highlighted item is a directory,
or [Ctrl+K] remove it and all subdirectories. Professional Mode must
be activated to remove directories with files in them.
[F8] Returns to the directory visited just before this one.
[Ctrl+F8] Compares files in the current directory against those in the
directory last visited. Tags files that are dissimilar,
retags those not in the other directory.
[F9] Save the current ELFTREE configuration settings.
[F10] Specifies what files you want ELFTREE to show or to exclude.
[F11] or Immediately searches for all files on all non-floppy drives
[Ctrl+F10] that match the current file specification set by [F10].
[F12] or Immediately searches for all files on the CURRENT drive that
[Ctrl+F2] catch the current file specification set by [F10].
────────────────────────────────────────
CTRL KEYS
[Ctrl+Right] If the item highlighted is a directory and the last key
tapped was not [Ctrl+Left], this enters that directory.
Otherwise, it moves forward to the next directory.
[Ctrl+Left] Moves to the Parent directory, or up to the most previous
directory if you are in the root directory.
[Ctrl+A] Steps through 7 predefined color schemes.
[Ctrl+L] Creates a disk volume label.
[Ctrl+P] Moves to the parent of the current directory, if any,
[Ctrl+V] Toggles between 25 and 43 line modes for EGA displays.
Cycles among 25, 28 and 50 line modes on VGA.
[Ctrl+T] Changes the date/time stamp for files.
[Ctrl+Z] Toggles if ELFTREE shrinks to 0K before running a program.
[Ctrl+S] Same as [Left]
[Ctrl+D] Same as [Right]
[Ctrl+E] Same as [Up]
[Ctrl+X] Same as [Down]
[Ctrl+R] Same as [PgUp]
[Ctrl+C] Same as [PgDn]
[Ctrl+F] Same as [Home]
[Ctrl+J] Same as [End]
────────────────────────────────────────
Part IV - Directory Information Screen Only
────────────────────────────────────────
MOUSE FUNCTIONS
Menu Bar Click on a menu selection to activate it. For example, click
on Print to activate it.
Description Double-click to activate help for the highlighted menu item.
Drive List Click on a drive letter to change drives.
Current Path Click on Drive portion to change drives, click on path
portion to show the previous file information area.
? - Help Click to bring up a help screen of what keys are active.
Click on a key to simulate tapping it.
Tree Left-click to highlight a directory, right-click to tag or
untag a directory, double-click to simulate tapping [Enter]
for a directory. Click and hold down a mouse button to move
selection bar to another directory (they will be tagged or
untagged if the right mouse button is held down).
Left Edge Click on left edge of screen to simulate [Left] key.
Right Edge Click on right edge of screen to simulate [Right] key.
Miscellaneous If a box appears on the screen, clicking inside the box (but
not on any 'hot spot') usually does the same action as
tapping [Enter]. Clicking outside the box (but not on the
mouse toolbar) usually does the same as tapping [Esc] to
cancel an action.
────────────────────────────────────────
CURSOR KEYS
[Right] Moves to the first directory below the current one in the next
column. If none, it moves to the next one in the same column.
[Left] Moves to the parent of the current directory.
[Up] Moves to the previous directory in this column.
[Down] Moves to the next directory in this column. If none, goes
one column to the right, if possible.
[Ctrl+Right] Selects the next item on the moving-bar menu.
[Ctrl+Left] Selects the previous item on the moving-bar menu.
────────────────────────────────────────
HOME, END, PGUP, PGDN
[Home] Moves to the first (root) directory.
[End] Moves to the last visible directory.
[PgDn] Moves to the last directory on the screen, then to the next
screen.
[PgUp] Moves to the first directory on the screen, then to the
previous screen.
────────────────────────────────────────
MISCELLANEOUS KEYS
[Ctrl+Enter] Selects the highlighted item on the moving-bar menu.
[Enter] Selects the directory for display of files, then shows
the items in this directory. If copying/moving files,
this just selects the destination directory.
[Esc] Leaves the directory screen; displays files.
[#] Displays directory statistics (# of dirs, # hidden, # tagged,
#of files in them, total size of files).
[Space] Tags/Untags the highlighted directory, updating the combined
size of the files affected.
[=] Searches for a directory name as you type it.
[Plus] or [+] Highlights the next directory in the tree. When you reach
the end, it starts over at the first directory.
[Minus] or [-] Highlights the previous directory in the tree. When you
reach the beginning, it starts over at the last directory.
────────────────────────────────────────
A through Z
[C] Copy tagged directories to another disk.
[E] Exposes hidden subdirectories of the highlighted directory.
[W] or [F] Find a directory by name. (accepts non-DOS names, too!)
[=] Searches for a directory name as you type it.
[G] Graft (attach) the tagged directories to another directory,
either on the same or another disk. The files can be
copied or moved. Great for reorganizing your directories
or moving some between nodes on a network!
[<] or [H] If directories are tagged, this hides them from view (they
are still visible from DOS). If none are tagged, this will
hide all directories that have not already been hidden that
appear to the right of the current column in the tree.
(You will be prompted to confirm this.)
[M] Move tagged directories to another disk.
[N] Make a new subdirectory of the one currently highlighted.
[>] or [O] Open Next Level - unhides (opens) the next column of
directories that were hidden with the Hide command.
[P] Print the directory tree as displayed.
[R] Rename the currently highlighted directory.
[S] Rebuilds the directory tree for the current disk.
[T] Tag the highlighted directory and all subdirectories.
[U] Untag the highlighted directory and all subdirectories.
────────────────────────────────────────
ALT KEYS
[Alt+Key] Search for a directory whose first letter matches `Key'. For
ex, [Alt+A] looks for the next one that starts with `A'.
────────────────────────────────────────
FUNCTION KEYS
[F1] Brings up help on using Directories.
[F2] Displays current status of many ELFTREE settings.
[F4] Customizes the style of the tree.
[F5] Rescans the subtree from the currently highlighted directory.
[L] or [F6] Display directory tree for another disk.
or [Shift+disk]
[DEL], [F7] Remove highlighted directory and all empty subdirectories.
or [Ctrl+K] If Professional Mode is on, you can remove directories with
files in them as well.
[F8] Toggles whether the [Enter], [Right] and [Left] keys affect
the moving-bar menu selections.
[F9] Saves the current directory tree to disk.
[F10] Changes what files are used when you select move, copy,
graft or [Enter].
────────────────────────────────────────
CTRL KEYS
[.] or [Ctrl+P] Go left to the parent directory of the one highlighted.
[Ctrl+V] For EGA adapters, this toggles between 25 and 43 line modes.
For VGA, this cycles among 25, 28 and 50 line modes.
[Ctrl+S] Same as [Left]
[Ctrl+D] Same as [Right]
[Ctrl+E] Same as [Up]
[Ctrl+X] Same as [Down]
[Ctrl+R] Same as [PgUp]
[Ctrl+C] Same as [PgDn]
[Ctrl+F] Same as [Home]
[Ctrl+J] Same as [End]
────────────────────────────────────────
Part V - Editing Keys (for editing popups only)
────────────────────────────────────────
CURSOR KEYS
[Right] Moves the cursor one column to the right.
[Left] Moves the cursor one column to the left.
[Home] Moves the cursor to the start of the field.
[End] Moves the cursor to the end of the field.
[PgUp,PgDn,
Up,Down] Ends editing (unless in DOS window).
────────────────────────────────────────
OTHER USEFUL KEYS
[Insert] Toggles between Insert and Overtype mode.
[Delete] Deletes the character at the cursor.
[Backspace] Deletes the character to the left of the cursor.
[Ctrl+Backspace] Deletes all characters immediately.
[Ctrl+End] Deletes all characters from the cursor on.
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Sorting Files █ Key: [F2]
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
ELFTREE provides numerous ways to order the files in the list. This
lets you look at them in many different ways and quickly reorganize
them. To prepare a sort, tap the [F2] key or click on F2 on the
mouse toolbar. A menu will appear, listing the sorting options
available (Name, Extension, etc.). These are explained below.
The primary sort order is highlighted, with either a '+' to the
left of it (for Ascending order) or a '-' to the left (for Descending
order). For example, ELFTREE's default primary sort is ascending
order by name, so Name is highlighted, with a '+' to the left of it.
To sort the items by Size in descending order, tap [-] to select
descending order, then tap [S] to select the Size option.
If using a mouse, clicking on a sort menu option will immediately
sort the files using that selection. In the area just below the
menu options, clicking on [+/-] will select Ascending or Descending
order, respectively, clicking on [Esc] will cancel the sort, clicking
on [SP] will toggle the +/- setting, and clicking on [Enter] will
perform the sort.
If two or more items are 'tied' after being compared with your
primary sort option, you may wish to specify a secondary sort
option to tell ELFTREE how to break the tie. To do this, choose F2
again (immediately after selecting the primary sort), and select
the option to use for breaking ties from the menu. Repeat this
if you wish to specify a third or fourth level sort option to break
ties. (The level currently being set is indicated on the last line
of the menu options window.)
Here is a description of each of the Sort menu options:
────────────────────────────────────────
BY NAME
▀▀▀▀▀▀▀
When you sort these items by name, the displayed files will be
listed in name-first order. For example, TODD.DOC would come
after STEVE.TXT, if the sort were in ascending order.
────────────────────────────────────────
BY EXTENSION
▀▀▀▀▀▀▀▀▀▀▀▀
After sorting by extension, for example, FIRST.BAS would precede
ALPHA.COM. In ascending order, an item with no extension would
precede any with an extension.
────────────────────────────────────────
BY SIZE
▀▀▀▀▀▀▀
When you sort your items by size, and choose descending order, the
largest files would be listed first, and the smallest ones last.
────────────────────────────────────────
BY DATE/TIME
▀▀▀▀▀▀▀▀▀▀▀▀
With this sort selected, if you choose ascending order, the oldest
files would be listed first, and the most recent listed last. Files
with identical dates are compared by time. If you do not wish to
have times compared automatically, select the Date Only option.
────────────────────────────────────────
BY DISK ORDER
▀▀▀▀▀▀▀▀▀▀▀▀▀
This option will list the items in the order in which they are on
the disk, or in the reverse of this order.
One way this can be used by you, for example, is if you want to
put frequently accessed files near the top of the chain, so DOS can
find them faster. To do this, first arrange the files in the order
you want them to be chained (use the REARRANGE key [F5] if needed),
then move them to a new directory, then move them back to this one.
(Or delete the old directory and rename this one.)
────────────────────────────────────────
BY ATTRIBUTE
▀▀▀▀▀▀▀▀▀▀▀▀
Sorting items by attribute is handy when you want to group all
files of similar attribute together, such as archived files that
need to be copied to a disk for backup.
────────────────────────────────────────
BY TAG
▀▀▀▀▀▀
This option lets you group all of your tagged, retagged and
untagged files together.
────────────────────────────────────────
BY PCT SLACK
▀▀▀▀▀▀▀▀▀▀▀▀
When a file is stored on a disk, it may not use all of the space
assigned to it. The term `slack' refers to that portion of the
assigned space that does not contain data for that file. For
example, a 12-byte file may be allocated 2,048 bytes of disk space,
which `wastes' 2,036 bytes of storage. This option lets you order
the files by the percentage of wasted, or slack, space.
────────────────────────────────────────
BY DATE ONLY
▀▀▀▀▀▀▀▀▀▀▀▀
This sort groups files with identical dates together. If you select
ascending order, older files would be listed before newer ones.
────────────────────────────────────────
BY TIME ONLY
▀▀▀▀▀▀▀▀▀▀▀▀
This sort orders files by time of creation. This can be handy, for
example, to see if anyone created any files in the wee hours of the
morning, or when you were away at lunch.
────────────────────────────────────────
NOTE: You can rearrange the file display in a manner impossible
by just sorting with the Rearrange [F5] key. This lets you move
one item at a time to a new position up or down in the display.
█▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ DOS Gateway █ Keys: [F3] or [X]
█▄▄▄▄▄▄▄▄▄▄▄▄▄█
The facilities available to you through the DOS Gateway let you:
1. Run a program with 2K or ZERO K of RAM overhead! Imagine
yourself pointing to a program to run, tapping [Enter], and
ELFTREE loading it! Then, when you exit the program, ELFTREE
reloads itself automatically.
2. Select commands from one of billions of menus that you create
(up to 100 commands per menu and 10 levels of submenus with
comments and user-specified Help lines and selector characters).
3. Execute DOS commands easily. In addition, ELFTREE remembers
the last 15 unique commands you used. It also provides a
quick, temporary exit to DOS (tap [O]), so you can work with
DOS (or 4DOS) for a period of time, if you need to, then return
to ELFTREE when ready.
4. Use short symbols to represent items that you want to include
in one or more commands. Here is a listing of them:
Group 1 - Macro symbols that provide objects for commands:
Symbol Alternate Description
======== ========= ===========================================
{CName} #C Drive:\Path\Name.Ext of current file
{Date} #V Current date
{Dext} #] Extension of current directory
{Dir} #| Name.Ext of current directory
{Dname} #[ Name of current directory
{Drive} #4 Current drive (e.g. [A:])
{Editor} #ü Name of currently defined editor.
{ETFind} #Ç Path to ETFIND directory.
{Ext} #E Extension of current file
{FName} #F Name.Ext of current file
{FDate} #G Date of current file
{FNote} #7 Note on current file
{FTime} #H Time of current file
{FSize} #5 Size of current file (flush left)
{LDrive} #? Former drive (e.g. [C:])
{List} #L Execute command against list of tagged files
{LPath} #/ Formerly displayed path
{Name} #N Name of current file
{Page} #P Current page (use for printing)
{Path} #\ Currently displayed path
{RSize} #6 Size of current file (right-justified)
{Temp} #@ Insert name of filenames of tagged files
{Time} #X Current time
Group 2 - Macro symbols that control command actions:
Symbol Alternate Description
======== ========= ===========================================
^ Join multiple commands
{COM1} #A Send string to serial port COM1
{COM2} #B Send string to serial port COM2
{DInput} #0 Default response to user input query
{ExitC} #. Exit to current directory after completion.
{ExitO} #, Exit to original directory after completion.
{Free} #* Free file space before executing program.
{GTag} #8 Run command group for each tagged file
{Input} #I Ask user for input to a command.
{LPT1} #1 Send string to printer port LPT1
{LPT2} #2 Send string to printer port LPT2
{LPT3} #3 Send string to printer port LPT3
{Macro} #J Stuff ELFTREE keyboard buffer for macro
{Menu} #é Displays menu, puts on command line.
{MoveTo} #D Move to program directory before executing.
{NoSaveTag} #} Don't save file tags before executing command.
{NoWait} #! Don't wait for a key after command execution
{Nozero} #Y Don't shrink to 0K
{Prompt} #Q Prompt user with message before continuing
{Repeat} #R Repeat last command until user stops
{Repeatall} #M Repeat all commands until user stops
{Retag} #O Re-tag file after execution completes
{SaveTag} #{ Save file tags before executing command.
{Stuff} #K Stuff DOS keyboard buffer before execution
{Tag} #T Run command for each tagged file
{UInput} #U Response to previous user input command
{UMenu} #â Response to previous {Menu] or {XMenu}.
{V25} #( Select 25-line video mode (all displays).
{V43} #) Select 43-line video mode (EGA only).
{V28} #- Select 28-line video mode (VGA only).
{V50} #= Select 50-line video mode (VGA only).
{VKeep} #9 Keep current video mode.
{Wait} #W Wait for a key after command execution
{XMenu} #ä Displays menu, does NOT put on command line.
{Zero} #Z Shrink to 0K prior to command execution
────────────────────────────────────────
IMMEDIATE MODE
▀▀▀▀▀▀▀▀▀▀▀▀▀▀
If ELFTREE is set up for Immediate mode, and the item highlighted
is a program that can be run, or has an extension that ELFTREE
is sensitive to, you launch the program by just tapping [Enter] or
double-clicking with the left or right mouse button.
────────────────────────────────────────
DOS WINDOW
▀▀▀▀▀▀▀▀▀▀
Tap [F3] or [X] (or click on F3 in the mouse toolbar) to open the
DOS Gateway. A window will appear, with a line in which to type a
command. For example, you could type the command DIR A: to get
a directory listing of the A: disk, or DATE to change the
system date. Once entered, tap [Enter] or click inside the box to
carry out the command.
To clear the text on the line, tap [Ctrl+Backspace] or click on
this symbol on the line below the command.
Tap [F3] to put the current file's name on the command line or, if
using a mouse, click on a file to put that file's name on the line.
COMMAND SHORTCUTS
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
ELFTREE offers you additional power by allowing you to combine
multiple commands, to use short symbols for commonly used objects
such as the name of a file, or to execute a command against all
tagged files. Here are examples:
- Multiple commands (use ^ to separate each command):
cd \^print config.sys^dir c:
- Insert file or directory information:
echo Last Drive:{LDrive}
echo Last Path:{LPath}
echo Current Drive:{Drive}
echo Full Current Path:{Path}
echo Short Path:{Dir}
echo Current Dir Name Only:{DName}
echo Current Dir Extension:{DExt}
echo Complete Name:{CName}
echo File Size:{FSize}
echo Right-Justified Size:{RSize}
echo Full Name:{FName}
echo Partial Name:{Name}
echo Extension:{Ext}
echo File Note:{FNote}
echo File Date:{FDate}
echo File Time:{FTime}
- Insert other information.
echo Current Date:{Date}
echo Current Time:{Time}
echo Your Editor:{Editor}
echo ETFIND Dir:{ETFind}
- Change current directory, run a command, and return.
C:\QPRO\Q.EXE {MoveTo}
(changes to C:\QPRO, starts up Quattro Pro, and returns to
the original directory when done.)
- Run a command against a list consisting of the names of the
tagged files. (DOS allows only 127 characters total!)
archive -a saveme {List}
- Run a command against a file consisting of the names of the
tagged files (1 name per line). Very useful for archiving!
archive -a saveme {Temp}
archive -a saveme {Temp} {NoZero} (do not shrink to 0K)
archive -a saveme {Temp} {Zero} (shrink to 0K)
- Ask for user input, with an optional message.
dir {Input}"Directory Name?"
dir {DInput}"{Path}"{Input}"Directory Name?"
dir {DInput}"{Path}"{Input}"Directory Name?"^cd {UInput}
Notes: A message must be surrounded by double quotes.
In the second and third examples, with {DInput}, the current
path is inserted before {Input} is called. Be sure to type
{DInput} BEFORE {Input} when using this!
To just give the user a message and have them tap a key to
continue, use {Prompt} instead of {Input}:
dir A:{Prompt}"~~Insert a disk in drive A"
- Pop up a small menu of items:
echo {Menu}"Choice 1,Choice 2,Choice 3"
echo {XMenu}"Choice 1,Choice 2,Choice 3"you chose {UMenu}
Notes: {Menu} causes the item to be placed into the command line.
To just display the menu, use {XMenu}. To insert the last
selection from {Menu} or {XMenu}, use {UMenu}.
- Stuff the DOS keyboard buffer, then execute the command.
backup {Stuff}12~
Note: These character(s) have special meaning:
~ - [Enter]
` - [TAB]
@ - [Esc]
? - Pauses macro until [Enter] is tapped.
=1 - [F1] (similarly for F2,...,F9)
=0 - [F10]
+1 - [Shift+F1] (similarly for [Shift+F2],...,[Shift+F9])
+0 - [Shift+F10]
(1 - [Ctrl+F1] (similarly for [Ctrl+F2],...,[Ctrl+F9])
(0 - [Ctrl+F10]
(A - [Ctrl+A] (similarly for [Ctrl+B],...,[Ctrl+Z])
)1 - [Alt+F1] (similarly for [Alt+F2],...,[Alt+F9])
)0 - [Alt+F10]
)A - [Alt+A] (similarly for [Alt+B],...,[Alt+Z])
!1 - the cursor key with `1' on it (i.e., End)
(similarly for !2 [DownArrow],..,!9 [PgUp])
[1 - [Ctrl] + the cursor key with `1' on it (i.e., [Ctrl+End])
(similarly for [2 [Ctrl+DownArrow],..,[9 [Ctrl+PgUp])
Macro expansion continues after a {Stuff} is encountered; the
keyboard is not stuffed until all have been resolved. (up
to 15 characters can be stuffed, unless your computer is using
a product such as THE BUFFER STUFFER that can expand the DOS
keyboard buffer to a larger size) For example:
Load Spreadsheet$C:\QPRO\Q.EXE {Stuff}/fo{Name}
This stuffs the keyboard with `/fo' followed by the name of the
highlighted file.
- Stuff the ELFTREE keyboard buffer. Up to 5000 keys can be
stuffed using this option (you must use the command-line switch
/K=#### to get more than the default of 100, however - see the
Help selection on Customize).
{Macro}ca~y
Note: This stuffs the characters [c], [a], [Enter] and [y], then
processes them)
- Make ELFTREE repeat a command, wait (or not wait) after execution,
process one command (or more) once for each tagged file.
print {Fname}{Repeat}
echo {FName}>PRN ^print {Fname}{Repeatall}
print {Fname}{Wait}
print {Fname}{NoWait}
print {Tag}{Fname}
echo {GTag}{FName}>PRN ^print {Fname}
- Set (or keep) the video mode before execution.
echo {V25}Now in 25 line mode. (EGA/VGA)
echo {V28}Now in 28 line mode. (VGA)
echo {V43}Now in 43 line mode. (EGA)
echo {V50}Now in 50 line mode. (VGA)
echo {VKeep}Video mode was not changed.
- Represent the current page number.
Note: Use this in a page header when printing.
{Date} {Time} Page {Page}
- Send a string to one of three printer ports.
{LPT1}"See me at port 1"
{LPT2}"See me at port 2"
{LPT3}"See me at port 3"
- Send a string (enclosed in double quotes) to a serial port.
Note: if a modem is hooked up to COM1, this can dial a number.
{COM1}"ATDT1-800-555-1212~"
{COM2}"ATDT1-800-555-1212~"
The ~ character is converted to a carriage return before
before the string is sent, and the symbol \0 is converted
to a null - binary zero - before sending.
These special characters, called macro symbols, give you a way to
create powerful commands. They are especially useful when part
of an ELFTREE user menu (described next) or with ELFTREE's
extension sensitivity (three sections down).
────────────────────────────────────────
USER MENUS
▀▀▀▀▀▀▀▀▀▀
ELFTREE can automatically load one of 13 menus when you tap the key
it is attached to. These menus can be activated from the file
information screen or the DOS Gateway, and they can each nest other
submenus up to 10 levels deep. You can also make ELFTREE load a menu
by attaching it to a specific file extension. See the section below
on Extension Sensitivity for more information.
The keys to which you can attach a menu are [U] (from the file
information screen only), [Alt+U] (from the DOS Gateway only),
and [Alt+F1] through [Alt+F12] (from either the DOS Gateway or
the file information screen). Note that you must have an enhanced
keyboard to use F11 and F12.
If you have a three-button mouse, clicking the middle button will
bring up the menu MENU.ETU from the File Information screen. From
the mouse toolbar, clicking on Menu will bring up this menu also.
To attach a menu to [Alt+F2], just tap the [Alt+F2] key or hold down
the [Alt] key with one hand and click on [F2] with the left or right
mouse button. You will be told that the menu does not exist, and
will be asked if you want to create it now. Answer [Y]. This loads
the editor with the menu file ALTF2.ETU. On each line of this file,
type a command you want to appear on the menu, preceded by a label
(recommended, but not required). Each line may be up to 500
characters in length (not including label); follow each label by a
single $ symbol.
COMMENTS
▀▀▀▀▀▀▀▀
To include a comment line in your menu file, put an asterisk (*) in
the first column of the line. If you want a comment to span several
lines, just begin EACH line with an asterisk.
USER-DEFINED HELP
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
To designate a line of text as a help descriptor for the next menu
selection, put an exclamation point (!) in the first column. When
you highlight a menu line that has Help associated with it, this
Help text will appear (centered) at the bottom of the menu panel.
USER-DEFINED SELECTOR
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
By default, the first character of each label denotes a key that,
when tapped, selects that item. If you wish a different selector
to be chosen for an item, just put an `@' symbol in front of the
character you wish to be used as the selector. Here is the menu
SAMPLE.ETU that comes with ELFTREE:
:Sample ELFTREE Menu
***
* This is to get you started designing a menu in ELFTREE.
* The basic ideas are:
***
* : Starts a menu TITLE.
* * Starts a COMMENT line.
* ! Starts a HELP line.
* @ Precedes the KEY that selects the item.
* $ Starts a COMMAND (and ends a menu description).
* Commands immediately follow the dollar symbol.
* Commands can use special symbols. See ELFTREE.HLP file for more info.
* Menu names (with extension .ETU) can be used as commands.
***
* Sample menu commands:
*
* Put the menu After the dollar ($)
* description ┌─ symbol, put the
* here │ command
* │ │ │
* │ │ │
*
Print @README.DOC $copy {ETfind}\README.DOC PRN
Print @AUTOEXEC.DOC $copy {ETfind}\AUTOEXEC.DOC PRN
Print @FEATURES.ET $copy {ETfind}\FEATURES.ET PRN
Print @Help file $copy {ETfind}\ELFTREE.HLP PRN
Print @Order form $copy {ETfind}\ORDER.DOC PRN
Print @Site License $copy {ETfind}\SITELICE.DOC PRN
Print S@ystem files $copy c:\config.sys prn^copy c:\autoexec.bat prn
*
!Note: You must have PKZIP for this to work.
Zip tagged files $PKZIP -a {Input}"Enter name of archive file:" @{Temp}{Nowait}
!Note: You must have PKUNZIP for this to work.
Unzip tagged files $PKUNZIP {Tag}{Fname}{Nowait}
!Note: You must have PKZIP for this to work.
Show ZIP file @contents $PKZIP -v {Fname}
You may use any of the special macro symbols defined in the preceding
section as part of the command for a menu selection.
All menu files you create must be stored in the directory where you
store your global search files (the environment variable ETFIND is
used to determine this - if you don't have one, then the menus go
into the directory where ELFTREE is stored).
Tap [Alt+F2] to activate the menu in ALTF2.ETU. To select an item
from it, use the cursor keys or the mouse to highlight it, then tap
[Enter] or double-click on it. Or, tap the key corresponding to the
first character of the item. If the selected item does not have a
label, and you activated the menu from the DOS Gateway, it will
appear on the command line so that you can modify it. Otherwise,
it will be executed immediately. If you decide that you want to
make a change to your menu, just tap [Alt+E] or click on the [Alt+E]
symbol, and ELFTREE will let you edit it again.
If you wish to make a menu for [Alt+F3], follow the same procedure,
but tap the key [Alt+F3] to get started. You can put up to 100
selections in each menu file.
The menu attached to either [U] (or [Alt+U]) is named MENU.ETU, and
is stored in the same directory as all of the other menus.
SUBMENUS
▀▀▀▀▀▀▀▀
To set up a menu item as a submenu, simply type the name of the menu
file (it must have the extension .ETU and be located in the same
directory as the other menus) after the '$' symbol. Here is an
example of a menu with both commands and submenus:
Utilities Menu $UTILS.ETU
*
!Format Disk in Drive A:
Format disk $format a:
*
Spreadsheet $C:\QPRO\Q.EXE
*
Database Menu $DBASES.ETU
*
Project Menu $PRJ.ETU
Select a submenu like any other menu item; just highlight it and tap
[Enter], or tap its selector key. The submenu will appear. Make a
choice from the submenu, or tap [Esc] to return to the parent menu.
IMMEDIATE KEYS
▀▀▀▀▀▀▀▀▀▀▀▀▀▀
If you create a menu with one selection, then tap the key for that
menu, ELFTREE will select that item IMMEDIATELY if you are in
Immediate mode . This convenience lets you use menus as "Immediate
Keys", or keys that carry out a command immediately upon activation.
In other words, if you are in Immediate mode, ELFTREE will only
display a menu if it has more than 1 selection on it, otherwise
it will execute the command in it IMMEDIATELY.
────────────────────────────────────────
AUTOMATIC LOADING
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
When the currently highlighted file has an extension of EXE, COM,
BAT or BTM, the name of the file will appear in the command line
when the Gateway is activated. This design lets you execute a
program by first pointing to it, then tapping [Enter], or by merely
double-clicking on it with the mouse.
ELFTREE can be much smarter than this, however. Read on.
────────────────────────────────────────
EXTENSION SENSITIVITY
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
You can make ELFTREE start your word processor when the highlighted
highlighted file has an extension of, say, DOC, or your spreadsheet
program when the current file's extension begins with W, or to show
a user-defined menu of commands if the extension is, say, ZIP. To do
this, tap [Alt+Enter] (or press [Alt] and click on the [Enter] symbol)
and type an ASCII file with this layout (the file extension is in
the first 3 columns):
DOC C:\MSWORD\WORD.EXE /c (parameters can be used)
W* C:\QPRO\Q.EXE (DOS wildcards can be used)
R?D C:\REFLEX\REFLEX.EXE {Fname} (macro symbols can be used)
ZIP ZIPSTUFF.ETU (user-defined command menu)
The file is named PROGRAMS.ELF and stored in the same directory as
the other ELFTREE files. Any time you read this directory (or at
startup), ELFTREE will be `sensitized' to these extensions. Once
sensitized, when you highlight the file REPORT.DOC (for example)
and tap [F3], the DOS window will pop up, and the command line will
look like this:
C:\MSWORD\WORD.EXE REPORT.DOC
Now, tap [Enter] (or click on it) and the program will be started.
Up to 40 extensions can be used in this file, and they can use the
wildcards `*' and `?'.
Notes: In Immediate mode you can tap [Enter] on a file with a special
extension and have ELFTREE load the program (and file)
Immediately. Tap [I] to toggle Immediate mode.
ELFTREE will allow you to have multiple PROGRAMS.ELF files.
When you enter a directory, ELFTREE looks for a PROGRAMS.ELF
file and, if it finds one, `resensitizes' itself to what is
in this new one. When you then move on to another directory,
ELFTREE stays sensitive to these extensions.
See the help on Viewing A File for related information.
────────────────────────────────────────
RAM USAGE
▀▀▀▀▀▀▀▀▀
When you run a program from ELFTREE using one of these methods, it
will release all but 2K of RAM to it! This lets you run memory-
hungry programs without worries about whether there's enough memory
free. For BAT or BTM files, ELFTREE frees up all but 6 or 7K,
depending on which DOS (or 4DOS) you use.
ZERO RAM USAGE
▀▀▀▀▀▀▀▀▀▀▀▀▀▀
To make ELFTREE unload itself completely from memory before running a
command or program, do one of these:
1. Use {Zero} somewhere in the command.
2. Tap [Ctrl+Z] once from the file information screen.
3. Click on Shrink: in the file information screen status line.
When unloading completely, ELFTREE builds a file called ETRUN.BAT,
then exits and runs this file. Because ELFTREE has to stuff the
keyboard with ETRUN~ before unloading itself, {Stuff} only has room
for 9 keys (15 total).
The ETRUN.BAT file is built in the directory where ELFTREE stores
all of its menus, trees, configuration files, etc., and is erased
when ELFTREE restarts.
────────────────────────────────────────
GO TO DOS
▀▀▀▀▀▀▀▀▀
To go directly to DOS from ELFTREE, just clear the DOS Gateway
command line and tap [Enter]. All but 6 or 7K of RAM is released.
The fastest way to get to DOS is to tap [O] from the file list.
────────────────────────────────────────
ELFTREE REMEMBERS
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
ELFTREE stores the last 15 commands entered in its DOS window. You
can cycle through a menu of them by tapping the [DownArrow] and
[UpArrow] keys or clicking on their respective symbols on the mouse
toolbar. To clear a command you no longer want remembered, tap
[Delete] or click on Del. To select the highlighted command, tap
[Enter] or double-click on it. To not select a command, tap [Esc].
To clear the command line, tap [Ctrl+Backspace] or click on this
symbol beneath the command line.
────────────────────────────────────────
PROBLEMS
▀▀▀▀▀▀▀▀
If a program refuses to run from inside ELFTREE, try this trick:
Type the phrase COMMAND.COM /C before the program name.
Here's an example of what this might look like:
COMMAND /C PESKY.EXE
If this doesn't work, then have ELFTREE completely unload before
trying to run the program. See the section above on ZERO RAM USAGE
for more information.
If none of these methods works, but the program runs fine from DOS,
please call so we can help you get it fixed!
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Customizing ELFTREE █ Key: [F4]
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
You can easily customize ELFTREE from within it! There is no
separate installation program to run. You can change the colors
displayed on the screen or the borders to use for popups, speed
up or slow down your keyboard, tell ELFTREE what items you want
to see when it shows you the contents of a directory, specify
what editor (or word processor) to use when you invoke EDIT, and
set dozens of other options. In addition, you can tell ELFTREE
how much memory to use for files, directories and other items.
NOTE: For all of these, you must SAVE [F9] your settings before
leaving ELFTREE, if you want ELFTREE to use them the next time.
────────────────────────────────────────
START CUSTOMIZATION
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
To customize, tap the [F4] key or click on the F4 symbol in the mouse
toolbar. A menu will appear, showing what items can be changed.
Some of these items are themselves menus of options. Select an item
to work with by tapping the key for it, by highlighting it and then
tapping [Enter], or by clicking on it with the mouse. Next is a
description of each menu option.
────────────────────────────────────────
Screen Colors/Borders (Submenu)
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
This menu allows you to change the colors of various screen elements
or the types of characters used to draw borders for boxes or columns.
Here is a brief description of each:
BOX BORDER TYPE
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
This determines the border (box) used on popup prompts and menus.
When selected, the inside of the menu will change to a prompt
telling you what to do next. Use [UpArrow]/[DownArrow] to cycle
forward/backward through the border styles. Continue until you
find one you like, then tap or click on [Enter] to keep it. If you
don't want to change the style, just tap or click on [Esc].
FILE BORDER TYPE
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
This gives you additional control over whether borders will be
drawn to separate the file information displayed, and lets you
choose the border that is most visually appealing. Nine (9)
types of borders are possible (including none at all). To select
one, tap or click on [UpArrow]/[DownArrow] to cycle forward/backward
through the selections and, when you spot the one you want, tap or
click on [Enter] to keep it. Tap or click on [Esc] to cancel the
selection. If you chose no border at all, ELFTREE will display at
least four (4) more lines of file information.
COLOR SELECTIONS
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
When you select a color option, a color table will appear in the
lower right corner of your screen, and the cursor will be located
at the current color of the item you selected. Just move the cursor
to the color you want (or click on a color), and watch how the color
of the selected item changes.
When you have found the color you want, just tap or click the [Enter]
key to keep it. Tap or click on [Esc] to go back to the original
color for that item.
────────────────────────────────────────
EDITOR PROGRAM NAME
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
ELFTREE has its own editor that can edit multiple files quickly
and efficiently. You can also use your favorite editor or word
processor with ELFTREE.
To indicate your editor, select [B] from the menu, and fill in the
box with the name (use the drive and path if you know them) of the
editor you want to use. For example:
C:\EDITOR\MYEDIT.EXE
Next, tell ELFTREE what parameters you wish to be included with
each invocation of the editor, if any. Feel free to use ELFTREE's
powerful macro symbols among the parameters. Then, you'll be
asked if your editor needs lots of memory. If you answer [Y] to
this, then ELFTREE will shrink itself to 2K of RAM before loading
the editor, giving it maximum RAM.
After you've entered all this, ELFTREE will check to see if the
editor is available, and will tell you if it cannot find it.
────────────────────────────────────────
FORMAT PROGRAM NAME
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
To format disks with ELFTREE, you need to tell it the name of your
formatting program. Most people use the one supplied with DOS,
which is called FORMAT.COM or FORMAT.EXE. Fill in the box with
the name that applies to your machine, if you know it. If you know
the directory it is stored in, enter this as well.
Next, tell ELFTREE what parameters to use every time it invokes the
formatting program. You should NOT enter any disk letters such as
A: or B:, ELFTREE will supply these when they are needed. In fact,
under normal circumstances, you will rarely need to enter any
parameters here. However, if you format disks of varying density on
a high-density, you will need to supply parameters at that time.
See the manual for information on building a FORMAT.ETU menu.
Ask your system specialist if you need help.
Tip: If your computer has 2 or more different diskette drives, you
can create a menu of format parameters and use the name of this
menu on the parameters line.
────────────────────────────────────────
KEY/MOUSE SETTINGS (Submenu)
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
This option pops up a window showing the current keyboard delay and
key repeat rate, and whether a mouse should be used. To change the
delay, tap or click on [A] or [Space] to cycle through the 4 choices
(1/4, 1/2, 3/4 and 1 second). To change the repeat rate, tap or click
on [B] to cycle through the choices. To test the current delay/repeat
selection, press (or click) and hold the [Up] or [Down] arrow keys.
The default settings are a 1/2 second delay and a repeat rate of
30 keys per second.
Tap [C] to toggle whether ELFTREE should look for and use a mouse
(if present). This resets any mouse driver and displays or hides
the mouse toolbar on line 1 of the screen. The default is Yes.
Note: Not all computers allow the keyboard to be customized.
────────────────────────────────────────
Miscellaneous Settings (Submenu)
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
These settings control various features of how ELFTREE behaves
when it is started, exited, looking for files, idle, searching for
text, or responding to command-type keystrokes. Here is a brief
description of what each option controls:
MODE
▀▀▀▀
Tap or click on [A] to change the Mode setting. The choices are
Delay and Immediate. In Delay mode (the default), a submenu choice
is automatically highlighted and ELFTREE waits for the user to
choose the next option. In Immediate mode, ELFTREE automatically
selects the highlighted option without requiring the user to tap
another key (or click once more with the mouse). Here's an example:
Suppose you tag a few files and choose the Copy tool. In Immediate
mode, ELFTREE will assume that you want the tagged files copied, so
it will activate automatically. In Delay mode, you have to tap [T]
or [H] to specify your choice. Delay mode thus offers maximum
flexibility, but Immediate mode offers maximum speed.
Immediate mode has other advantages. If the highlighted file is
a program, or the data file associated with a program that you've
trained ELFTREE to recognize, you can run it by simply tapping or
clicking on [Enter]. If a directory is highlighted, you can enter
it by tapping [Enter] or double-clicking on it. This makes ELFTREE
even simpler to use.
Note: From the file screen, tap [I] or click on the Mode setting in
the file statistics line to toggle the mode.
CASE (looking for text)
▀▀▀▀
Tap or click on [B] to change the Case setting, which is used when
searching for text. By default, upper and lower case are considered
equal when searching so that, if you were searching for ELFTREE, it
would find elftree, Elftree, ELFTREE and so on.
The four (4) choices for Case are:
Respect - find exact matches only.
Ignore - find matches that agree except for case.
Ask - ask about case sensitivity before searching.
Smart - If the string to look for has both UPPER and lower case
characters, then case is respected, otherwise it is
ignored. For example, a search for `Copyright' would
respect case, but not for `copyright'.
OPEN CHOICES
▀▀▀▀▀▀▀▀▀▀▀▀
Tap or click on [C] to change what ELFTREE shows at startup - Files,
Tree or Menu. The default is Files, which shows the files from the
current directory. You may prefer to always see the directory
tree first, however, or the commands you've put into a menu file.
If you choose `Menu', you can control which main menu will appear
with the STARTUP MENU option.
EXIT CHOICES
▀▀▀▀▀▀▀▀▀▀▀▀
Tap or click on [D] to change how ELFTREE exits. You can have it
always drop you off in the Current directory or the Original directory
(where you started ELFTREE up), or you can make it always ask before
exiting. This latter option is handy if you tend to `lean' on the
[Esc] key. The default is Ask.
STARTUP MENU
▀▀▀▀▀▀▀▀▀▀▀▀
When ELFTREE is told to Open In a menu (see above), you can tell
it which menu to open to with this. Every time you select this
option, the next possible menu is selected. There are 13 menus
that can be initiated on startup, and they are attached to the
[U] and [Alt+F1]-[Alt+F12] keys. For example, if MENU.ETU is
the current choice, then ALTF1.ETU would appear next when you
select this option. Tap or click on [E] to cycle through the menus.
SCREEN SAVE
▀▀▀▀▀▀▀▀▀▀▀
Tap or click on [F] to make ELFTREE blank the screen after a certain
number of minutes of inactivity. Enter how many minutes to wait
before blanking the screen in the box provided. To not have the
screen blanked (the default), use a setting of 0.
To make ELFTREE immediately blank the screen, hold down both [Shift]
keys on your keyboard.
When the screen is saved, a message can appear at random locations
indicating this. The file SNOOZE.ELF contains these messages, so
you can change them by editing the file.
Up to 40 messages can appear in this file. Each message can span
several lines, and must be separated from each other by a blank line.
(If no SNOOZE.ELF file is present, no message is displayed.)
To bring the screen back, just tap a key or click or move the mouse.
FILE SEARCH SPEC
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
Tap or click on [G] to change what files and/or directories will be
displayed in the file information area. Two steps are needed:
Step 1- tell ELFTREE what names to use when it is looking for things
to show you. When you first start ELFTREE, this is "*.*", which
means "show me everything that's out there". However, you might want
ELFTREE to display only your memos, which have an extension, say, of
MMO. No problem! Just enter *.MMO, and only these will show.
However, you may want ELFTREE to display files that match a group
of names, instead of what can be given in one specification. To
do this, simply type more such specifications, separating each
item by a colon (:). (For your convenience, semicolons are
changed to colons.) For example, to bring up only files with
an extension of .COM, .EXE or .BAT, this will do the trick:
*.COM:*.EXE:*.BAT
ELFTREE understands search specifications that DOS cannot, such
as "*94*", which means "show me files that have 94 in the name",
or "AB*C*DE", which means "show me files that begin with AB, end
with DE and have C somewhere between them".
If no file specification is supplied, the default is "*.*".
Regardless of the file specification you enter, you have the option
of `reversing' it - that is, show all files EXCEPT those that match
this spec. To reverse it, just tap or click on [F10] instead of
[Enter] when you are through typing in the specification.
Step 2 - Indicate what types of items that have such names should
be included. You can specify hidden, system, read-only, or archived
files, and you can specify whether directories, labels, or files
with no attributes (called Normal files by DOS) are included. If
a selection on this menu has a Yes by it, then it will be included;
otherwise, it will be excluded. By default, files that are marked
as Hidden and/or System are not displayed (and you should NOT change
any files with these attributes already set!). To change a Yes to a
No, or vice versa, just highlight the selection and tap or click on
[Space], or tap or click on that item's selector key.
PROGRAM SHRINK
▀▀▀▀▀▀▀▀▀▀▀▀▀▀
Tap or click on [H] to change how ELFTREE shrinks itself when running
a program. It can either leave a small kernel of itself (about 2K)
in memory (the default), or not.
NOTE TYPE
▀▀▀▀▀▀▀▀▀
Tap or click on [I] to choose the type of note file ELFTREE uses.
This file is used to store notes about files and directories. The
three types are ET (the default), 4DOS and ProFinder. If you use
4DOS (a shareware replacement for COMMAND.COM), you will most likely
want to use the 4DOS selection so that you can edit the notes in
ELFTREE but still have the changes kept in 4DOS.
────────────────────────────────────────
Switches (Submenu)
▀▀▀▀▀▀▀▀
This menu controls the operation of various switches, such as how
ELFTREE responds to the Alt and Ctrl keys, whether borders appear
between the columns of file information, whether noise feedback is
permitted, etc.
ALT/CTRL LOCK
▀▀▀▀▀▀▀▀▀▀▀▀▀
Tap or click on [A] to toggle whether the Alt or Ctrl keys can be
'locked' by tapping either one twice. Once locked, the behavior of
normal keys is modified by the status of the locked key. For example,
[A] becomes [Alt+A] or [Ctrl+A]. This was designed as a convenience
to those users for whom typing is a challenge, but it can also be
used to circumvent the action of a `hotkey' for a resident program.
ELVISH TOUCH
▀▀▀▀▀▀▀▀▀▀▀▀
Tap or click on [B] to toggle whether the Alt or Ctrl keys must be
held down simultaneously when selecting a key. When activated, you
can enter [Alt+A] by tapping [Alt], then [A]. This is handy for
people who find typing bothersome, such as people with arthritis,
or executives who are not used to typing on a keyboard.
FILE COLUMNS
▀▀▀▀▀▀▀▀▀▀▀▀
Tap or click on [C] to toggle whether vertical lines separate the
columns of file information. The default is Yes; however, columns
will still not be shown if the border type (see next item) is hidden.
Note: Tap [B] from the file screen to toggle this setting.
QUIET
▀▀▀▀▀
Tap or click on [D] to toggle whether ELFTREE is allowed to beep when
it needs to get your attention. The default is Yes.
STORE TREE
▀▀▀▀▀▀▀▀▀▀
Tap or click on [E] to toggle whether directory trees for fixed
disks are stored so that they do not have to be rebuilt each time
a disk is accessed (this is the default).
VIEW SHRINK
▀▀▀▀▀▀▀▀▀▀▀
When you tap [V] to view a file, ELFTREE checks to see if it should
run an external program to view it (this is controlled by the file
VIEWERS.ELF). If it finds one, this option determines whether it
shrinks itself prior to running the viewing program.
DIRS FIRST
▀▀▀▀▀▀▀▀▀▀
When ELFTREE grabs the files from a directory, and the directory has
subdirectories, this option controls whether they always appear at
the beginning of the list, or if they will be mixed with the files.
If they are placed at the beginning, they will always be in
alphabetical order. (This option does not apply to files gathered
from the Find command.)
GROW POPUPS
▀▀▀▀▀▀▀▀▀▀▀
When ELFTREE opens a window to give you a message or to have you
type in some text, it can either open the window immediately at full
size, or grow it a bit more slowly. This option lets you control
how the windows appear. Choose 'Yes' (the default) if you prefer
flashier popups, and 'No' if you prefer instant popups.
VALIDATE TREE
▀▀▀▀▀▀▀▀▀▀▀▀▀
When you display the directory tree, a quick check is done to see if
any subdirectories have been added to the current directory, or if
the tree may need to be rebuilt. Choose 'Yes' (the default) to
activate this option, and 'No' to deactivate it.
SET ARCHIVE
▀▀▀▀▀▀▀▀▀▀▀
When a file is copied or moved from one location to another, the
file's attributes are copied also. Making this option 'Yes' ensures
that the archive attribute 'A' is set for the target file. The
default is 'No'.
SAVE COMMANDS
▀▀▀▀▀▀▀▀▀▀▀▀▀
When you exit ELFTREE, commands entered through the DOS Gateway
or the Menu system can be saved by setting this option to 'Yes'.
The default is 'No' (commands are not saved).
SCAN CONFIRM
▀▀▀▀▀▀▀▀▀▀▀▀
When you tap [S] to rescan a directory tree, you will be asked to
confirm it if this option is set to 'Yes' (the default).
SHOW NOTE LETTER
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
Setting this option to Yes displays the first letter of a note
instead of the paragraph symbol (ASCII 20). The default is 'No'.
SHOW FILE SPEC
▀▀▀▀▀▀▀▀▀▀▀▀▀▀
Setting this option to Yes displays the file search specification
on the screen line just above the file status area.
SHOW NAME.EXT
▀▀▀▀▀▀▀▀▀▀▀▀▀
Setting this option to Yes displays file names as NAME.EXT instead
of putting the extensions in a separate column.
DEL BEFORE COPY
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
Setting this option to Yes forces a file to be deleted before it is
copied over. This is handy for people using a program that puts
deleted files in a protected directory.
────────────────────────────────────────
Advanced Switches (Submenu)
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
This menu controls numerous options that are of concern to the
person who uses ELFTREE intensively.
ALWAYS FREE FILESPACE
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
This option makes ELFTREE more aggressive in reducing memory
before running programs that do not ask it to shrink. With this
activated, memory for files, directories and notes is freed
prior to running a program, and reallocated afterwards. (If
not activated, ELFTREE will still free such memory if it detects
that the program might need it.)
COPY OVERWRITE
▀▀▀▀▀▀▀▀▀▀▀▀▀▀
When copying or moving files, ELFTREE is careful not to overwrite
any existing file without first asking permission to do so. If
this option is activated, you tell ELFTREE not to ask permission.
PROFESSIONAL MODE
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
This setting controls whether directories with files in them can
be erased, and whether the word 'Drive' should appear under the
root directory name on the tree.
PROMPT FOR ERASE
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
When this is turned on, each time you tap [F7] or [Del] to erase
one or more files, ELFTREE will ask 'Erase Files?' before doing so.
This prompt is designed to protect the user who may tap [Del]
by mistake when they think they are tapping a different key.
Note: Professional mode must be ON to activate this.
USE UNIQUE EXIT KEY
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
Some people `lean' a little heavily on [Esc] when backing up from
menus, or responding to an option. If ELFTREE is set to Exit to
either the Current or Original directory, the user may be tossed
out to DOS unexpectedly. This option prevents the [Esc] key from
being used to exit from ELFTREE, and allows the user to designate
which key to tap to leave ELFTREE.
SAVE FILE TAGS
▀▀▀▀▀▀▀▀▀▀▀▀▀▀
To make ELFTREE remember which files are tagged after running a
program, set this option to 'Yes'. If the program deletes or
creates files, these will be included only when working locally.
ENHANCED KEYBOARD
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
Normally, ELFTREE automatically senses whether you have an enhanced
keyboard attached to your computer. This option lets you override
what is detected. You can also use the command-line switch /Y=#
to control this setting.
GET TRUE NAMES
▀▀▀▀▀▀▀▀▀▀▀▀▀▀
When you change directories or disks, ELFTREE asks your operating
system (DOS, usually) for the logical name of the current directory.
If the drive used is not on a network, ELFTREE then asks for the
'actual', or 'true' name (in case the drive was aliased by SUBST).
Since this uses a feature of DOS that does not work reliably on all
work-alikes (network shells, DR-DOS, etc.), this lets you control
when ELFTREE uses it.
────────────────────────────────────────
COMMAND LINE SWITCHES
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
In addition to this customize menu, you can configure ELFTREE with
certain command-line switches that you type after the ET that gets
ELFTREE up and running. Here are the switches that may be used,
and what they represent:
/#=<char>- If you prefer not to use '#' as the symbol that identifies
a macro symbol (for example, you may have files with '#' in
their names), use this to select another symbol. For example,
to make '+' the symbol, use /#=+
/4 - Use 4DOS-style note files (file name DESCRIPT.ION).
/5 - Use ET-style note files (file name ELFTREE.NTE).
/6 - Use ProFinder-style note files (file name TITLES.PF).
/C - if you have a composite monitor.
/D=#### - Set maximum # of directories to handle. Each uses
16 bytes. (max is 3,999; default is 1000)
/F=#### - Set maximum # of files to handle. Each uses 22 bytes.
(max is 16384; default is 5000)
/G=#### - Set maximum # of directories that Find can handle.
Each uses 64 bytes. (max is 999; default is 50)
/H=# - If # is 1, this activates high-speed disk scanning routines
for non-networked drives.
(default is 1, or ON; /H=0 turns it off)
Note: A separate logical variable is maintained for high-speed
scanning in the OS/2 Compatibility Box. This switch affects only
that variable's setting.
/K=#### - If # is at least 10, this refers to the number of internal
macro keys to allow. (max is 5000; default is 100)
/L=Z - Sets last drive accessible to user. (default is Z)
/N=#### - Set maximum number of notes to handle. Each one uses 64
bytes; the space is shared with /G=####.
(max is 1,000; default is 50)
/R=### - ASCII code of `retag' character to use (1-255).
(default is 9, which looks like a hollow circle)
/T=### - ASCII code of `tag' character to use (1-255).
(default is 4, which looks like a solid diamond)
/U=#### - if #### is at least 500, this sets the maximum allowable
length of a menu command line.
(max is 10,000; default is 500)
/Y=# - If you do not have an enhanced keyboard, but you want
ELFTREE to think that you do (this will let you use
[Ctrl+Del] and other nonstandard keys), use 1 for #.
Use 0 for # if you do not want ELFTREE to use any of
the enhanced keyboard facilities, even if you have
such a keyboard. (default is 1 if an enhanced keyboard
is detected, and 0 if not)
Here is an example of how to set up ELFTREE to use 2,000 files,
300 directories and 500 notes per directory:
ET /F=2000 /D=300 /N=500
Be sure to tap SAVE [F9] if you want these to be permanent.
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Rearranging The Order of Files █ Key: [F5]
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
If you can't order the files in the list by sorting them, ELFTREE has
a feature just for you.
For example, how can you
arrange these files: Like this?
FIRST .A FIFTH .E
SECOND .B FIRST .A
THIRD .C SECOND .B
FOURTH .D SIXTH .F
FIFTH .E THIRD .C
SIXTH .F FOURTH .D
With ELFTREE, this is no problem. Just highlight the item to move
and tap the Rearrange [F5] key (or click on F5). You can now drag
the item up or down to a new location by using the [Up] or [Down]
keys, or click on another file name to put the file above the one
that was clicked on. When it's at the new location, tap [Enter]
or [Esc] (or click on them) to quit rearranging.
So, in the above example, I would highlight FIFTH.E, tap [F5], tap
[Up] 4 times, tap [Enter], then highlight SIXTH.F, tap [F5], tap [Up]
2 times, and tap [Enter].
Note: When you SORT [F2], all rearranging you did previously is
cleared, and the items are sorted as you wish.
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Changing Disks █ Keys: [F6], [L] or [Shift+disk]
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
To look at a different disk or reread the current directory tap the
Change Disk ([F6], [L]) key, then tap the letter of the disk to use.
If using the mouse, click on the drive letter to change from the list
of drives appearing above the Current Path.
Note: Another way is to tap [Shift+disk].
If the drive specified is not available for some reason, you'll
be told by ELFTREE when it returns. If you are trying to change
to a floppy drive, and ELFTREE detects that the disk is not
readable, it will ask if you want to format it. If you do not
(it could destroy any data on the disk), simply tap [Enter] to
answer NO to this choice.
You can change disks from either the file information screen or
the directory tree display. If you change from the tree, ELFTREE
will automatically get the tree for the disk specified. If you
change from the file information screen, ELFTREE will bring up
the files in the current directory for that disk.
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Erasing Files or Directories █ Keys: [F7], [Del] or
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█ [Ctrl+K]
You can erase one or several items at a time in ELFTREE. The files
can be recovered with a number of utility programs on the market
unless you choose to Wipe the files, which causes the files to be
completely overwritten with null characters. Disk volume labels
can be erased as well. To create a new label, tap [Ctrl+L].
────────────────────────────────────────
ERASING ONE FILE
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
To erase one file, simply highlight it and tap ERASE ([F7] or [Del])
or click on Del on the mouse toolbar. (Note: [Ctrl+K] can also be
used.) A box with ERASE FILE(S)? will appear, to verify that you
tapped the intended key. Answer with a tap of the [Y] key or by
clicking on the [Yes] box if this is what you meant (or tap [W] or
click on [Wipe] to wipe the files). If you did not mean to erase
anything, tap [N] or [Esc], and this will be cancelled. Otherwise:
If no files are tagged, the highlighted file will be erased.
If one or more files are tagged, another box will appear, (if you
are not in Immediate mode) asking if the [Hilighted] or [Tagged]
files should be erased, or if you want to [Cancel] erasing.
If files are tagged, the selected file can be erased by choosing
[Hilighted] (tap [H] or click on it with the mouse pointer).
If the highlighted item is a directory, and no files are tagged,
the message in the box will be REMOVE DIRECTORY? instead. See
the discussion further down for more on this.
────────────────────────────────────────
ERASING SEVERAL FILES
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
To erase several files, simply `tag' them and tap the ERASE key.
The message ERASE FILE(S)? will appear, to check to see if this
is what you want to do. Tap [Y] or select [Yes] to proceed, then
tap [T] or select [Tagged] to start erasing the tagged files.
To interrupt erasing, tap [Esc] or click on Esc. To resume, tap
[R] or click on [Resume]. To cancel, tap [Esc] or select [Cancel].
────────────────────────────────────────
REMOVING A DIRECTORY
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
Tap [Del] on a selected directory to remove it. Of course, to remove
a directory, it (and all of its child directories, if any) must be
empty of files. A child directory, if it exists, will appear to the
right on the directory tree display. Here's a sample:
.
.
│
├─ PARENT ──────┬─ CHILD1
│ └─ CHILD2
.
.
Here, PARENT cannot be removed, even if it has no files in it, unless
CHILD1 and CHILD2 are empty. If CHILD1 and CHILD2 are empty, they
will be removed immediately and ELFTREE will attempt to remove PARENT.
As a convenience, you can remove a directory from either the directory
tree display or the file information area.
As a further convenience, if you select a directory from the tree
that no longer exists, ELFTREE will automatically adjust its tree.
This may happen, for example, if you remove a directory using DOS
or another program.
────────────────────────────────────────
REMOVING A DIRECTORY (PART II)
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
If you would like ELFTREE to be capable of deleting the files in a
directory automatically, instead of having to delete them yourself
ahead of time, there is a way to do this. From the Advanced Switches
menu under Customize, set Professional mode to Yes (the default is No)
to activate it.
When Professional mode is active, you will be warned if files exist
in one or more directories to be deleted, and a box of choices will
appear. The options shown mean:
[N] - Cancel delete request.
[F] - Erase just the files in the parent and subdirectories,
but leave the directory structure intact.
[O] - Erase just the files in the parent directory.
[S] - Erase ALL files in parent and child directories, and
remove the directories as well.
[Y] - Erase ALL files in the parent directory, and remove
it as well.
To select an option, either click on its box or tap the letter that
appears in the box.
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Return To Last Directory █ Key: [F8]
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
You can quickly return to the directory you were in last by tapping
the Last Directory [F8] key or clicking on F8. To return to the
directory you left, tap [F8] again.
This is handy when you need to compare two directories before
copying or moving files from one to another, or if you simply
need a quick way to return to where you came from.
Compare Directories
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
Tap [Ctrl+F8] (or press [Ctrl] and click on F8) to quickly tag files
in the current directory that are also in the last directory you
visited, but are not identical due to their having a different size
or date/time stamp. Files which are not in the other directory will
be 'retagged', which you can promote to 'tagged' with the Tag Retag
command. If you wish to also process the previous directory, simply
switch back to it with [F8], then select [Ctrl+F8] again.
You have two choices on the comparison. The Slow option compares
files of the same size on a byte-by-byte basis to see if they are
identical. The Fast option does not perform an internal comparison;
it just looks at the file properties.
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Save ELFTREE Settings █ Key: [F9]
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
When you change ELFTREE outside of the Customize [F4] menus, these
changes are not saved until you tap or click on the SAVE [F9] key.
This creates a file called ELFTREE.CFG in the directory where
ELFTREE's menus, tree maps and Find files are stored. To use a
configuration file with a different name, use the environment
variable ETCONFIG to set it. For example: set ETCONFIG=MONO.CFG
You can VIEW the configuration file with ELFTREE, and can make
changes to it with an editor, although this is not recommended.
ELFTREE.CFG currently stores such items as the colors to use, the
number of lines to use on the screen, the number of lines you were
using before invoking ELFTREE, the file search specification, the
Find search specification, the name of your editor, any editor
parameters you want, etc. The DOS commands you used during a
session are saved in ELFTREE.CMD (if you set the switch to save them).
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Go To Child Directory █ Key: [Ctrl+Right]
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
If the currently highlighted item in the file information area is a
directory, jump into it by tapping [Ctrl+RightArrow] (in Immediate
mode, just tap or click on [Enter]). The files in this directory
will appear.
────────────────────────────────────────
GO TO PARENT DIRECTORY
▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
To quickly go to the parent of the current directory, tap the PARENT
[Ctrl+LeftArrow] or [.] key. This will display the files from the
parent directory, and the directory just left will be highlighted.
If you are in the root directory when you tap this key, you will be
moved up to the next previous directory in the list, if one exists.
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ For EGA/VGA Displays █ Key: [Ctrl+V]
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
If your computer has an EGA or VGA display, you can see more
information at a time by changing the number of lines ELFTREE shows
on the screen.
────────────────────────────────────────
HOW TO ACTIVATE EGA/VGA MODES
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
To change the number of lines on the screen, just tap [Ctrl+V]
(hold down the Ctrl key and tap V). If you are viewing a file,
looking at your directories, or looking at the menu screen, you
will switch to the next mode automatically.
The available number of lines per screen are 25/43 for an EGA, and
25/28/50 for a VGA. So, if your current screen is set for 25 lines,
your next one will be 43 for an EGA, and 28 for a VGA. If you tap
[Ctrl+V] one more time, you'll get 25 on an EGA, and 50 on a VGA.
On a VGA, one more tap will get you back to 25 lines.
This is a handy way of getting more information (directories,
files, browsed file) on your screen at a time. You will find
the directory tree display gives you almost twice as many branches
in 43 line mode as in 25, and thus you get a better picture of your
disk directory structure.
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Change File Date and Time █ Key: [Ctrl+T]
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
You can change the date and time of one or many files with
ELFTREE. This is handy, for example, if you are working on a
group of files in a project, and you want them all to have the
same date and time.
To change the date and time for one or more files, tap
CHANGE FILE DATE [Ctrl+T]. A box will appear, and you should enter
the date and time desired where indicated. Be sure to follow the
format supplied in the example.
For example: 1-1-90 12:00p is a valid date
(Note: Tap or click on [F10] to put in the current date and time.)
If no files are tagged, the highlighted file's date and time will
be changed to what you specified.
If one or more files are tagged, another box will appear, asking
whether you want to process the [Hilighted] or [Tagged] files, or
just want to [Cancel] the operation.
If you have tagged files, you change the highlighted file by either
tapping [H] or clicking on [Hilighted].
To change the date and time for the tagged files, just tap [T] or
click on [Tagged].
█▀▀▀▀▀▀▀▀▀▀▀▀█
█ Attributes █ Key: [A]
█▄▄▄▄▄▄▄▄▄▄▄▄█
You can use ELFTREE to provide some additional security to your
computer system by marking your important files as `read-only',
`hidden', or `system'. Also, ELFTREE will show you the current
attributes of the items displayed in the last column. Here is
a brief description of what each symbol displayed there means:
────────────────────────────────────────
[R] READ ONLY
▀▀▀▀▀▀▀▀▀
When you make a file `read-only', you tell DOS that it is not
allowed to make changes to the file. This prevents others from
erasing it easily. Of course, you can use ELFTREE to erase a
`read-only' file, but the DOS Erase command will give you the
message `Access denied'. As a rule, you should never make data
files `read-only', or else the programs that use them will probably
not function correctly. For example, if you make ELFTREE.CFG
`read-only', then you will not be able to save any configuration
changes you make to ELFTREE.
────────────────────────────────────────
[H,S] HIDDEN/SYSTEM
▀▀▀▀▀▀▀▀▀▀▀▀▀
Marking a file as `hidden' or `system' keeps it from being shown
by DOS when you give a DIR command (this is true for hidden
directories as well). This is a good way to keep casual snoops
from seeing what you have on your disks. If you have DOS 3.0
or later, you can hide executable files (such as ELFTREE.EXE),
yet still run them as if they weren't hidden! Be careful of
unhiding files that come with your software; the files might
be part of a copy protection scheme, and unhiding them could
prevent the program that uses them from working.
NOTE: If you mark files as `hidden', `system', or `read-only', any
disk defragmentation program you use will NOT MOVE THESE
CLUSTERS. If you want them reorganized, you'll have to
change their attributes, then run your defragmentation
program, then change them back. Use the ELFTREE Find feature
to help you if the files are spread across many directories
directories or on many disks.
────────────────────────────────────────
[A] ARCHIVED
▀▀▀▀▀▀▀▀
When you make changes to a file, DOS sets the `archive' attribute
to denote that it needs to be backed up. Backup programs that
perform so-called `incremental' backups look for files that have
their `archive' attribute set.
────────────────────────────────────────
[D] DIRECTORY
▀▀▀▀▀▀▀▀▀
This marks the item as a directory (as opposed to a file or a disk
volume label). ELFTREE can hide directories as well as files, and
can make directories `read-only' also. Hiding a directory is a
quick way to hide the files it contains as well.
────────────────────────────────────────
[L] LABEL
▀▀▀▀▀
This marks the item as a disk volume label (name on the disk).
────────────────────────────────────────
[N] NORMAL
▀▀▀▀▀▀
A file with no attributes is called a NORMAL file.
────────────────────────────────────────
Changing Attributes
It's easy to change attributes with ELFTREE. Select Attribute
from the menu bar, and a box will pop up. In this box will be the
attributes you can change (Archive, Read-only, Hidden and System).
In front of each of these will be `N/C', which means `no change'.
Simply select the attribute you want to change, and tap [Space] or
click on it to cycle through the choices. The `Yes' choice means
`give the item this attribute', and `No' means `remove this attribute
from the item'.
After selecting the desired attributes, tap or click on [Enter] and
the files/directory will be given these attributes.
Note: You can also tap or click on [+] to set an attribute to 'Yes',
or tap or click on [-] to remove it.
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Copying Files and Directories █ Key: [C]
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
You can copy one or many files (even entire directories) with
ELFTREE, and with just a few keystrokes! With a little practice,
you'll swear off DOS forever for copying your files.
You may be aware already that when you use DOS to copy a file,
and already have a file with the same name on the disk, DOS may
overwrite that file without any warning message. This can cause
you to lose data!! ELFTREE will not overwrite files unless you
specifically tell it to do so. Also, if you have a note attached to
a file, the note will be copied with the file if there is no file
with that name in the directory you are copying to.
────────────────────────────────────────
HILIGHTED
▀▀▀▀▀▀▀▀▀
Assuming no files are tagged, you can copy a file by selecting the
Copy command from the menu bar (tap [C] or click on Copy). If files
are tagged, a submenu will appear - select Highlighted from this.
Next, find the drive and directory to copy the files to (or make a
new directory, if needed), tap [Enter] or double-click on it, and sit
back and let ELFTREE copy it.
You can duplicate a file by selecting the same directory for the
destination, or by using the ["] key. ELFTREE will ask you to
enter a name for it, and then proceed to copy it.
────────────────────────────────────────
TAGGED
▀▀▀▀▀▀
After tagging the files to copy (by tapping [Space], using the TAG
menu command or right-clicking on them with the mouse), copy them by
selecting Copy Tagged from the menu bar. Next, find the directory
to copy the files to (or make a new one, if needed), tap [Enter] or
double-click on it, and sit back and let ELFTREE copy the files.
If you don't want ELFTREE to ask for permission about replacing
files that may exist in the target directory before starting to copy
the tagged files, change the Copy Overwrite option in the Advanced
Switches submenu under Customizing. Be careful, though - you may
replace files you didn't intend to replace!
COMBINING TAGGED FILES [&]
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
To combine several files into one, just tag them and use the `&'
key to indicate that you wish to copy them into one file. ELFTREE
will ask you for the name of the file to copy it into, and then start
pouring the contents of these files into the one you specified.
────────────────────────────────────────
COPYING ENTIRE DIRECTORIES
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
ELFTREE can copy entire directories from one disk to another. To do
this, you must be looking at the directory tree (tap [D] or click on
DirTree to get to it). Now, tag the directories you want copied.
Here's how to tag them:
1. Tap [Space] to tag an individual directory.
2. Right-click on a directory touched with the mouse pointer.
3. Tap [T] or click on Tag - to tag the current directory and all
of its subdirectories. (Hint: to tag all directories on a
disk, move to the root directory before selecting Tagged.)
4. Tap [U] or click on Untag - to untag the current directory and
all of its subdirectories.
Now, tap [C] or click on Copy, tell ELFTREE what disk to copy to,
and sit back and let ELFTREE copy the directories.
As ELFTREE copies files, it checks to see if there's enough room
on the disk to store the copy. If there is not, and you are
copying to a floppy, ELFTREE will tell you there is not enough
room to copy the file, and will let you Skip the file, put in a
fresh disk and Continue, or Quit copying altogether. If you put
in a disk that has not been formatted, ELFTREE will give you an
error message (such as "Unreadable disk in Drive A"), and then ask
if you want to format the disk right now. Tap [Y] or click on Yes
to format it, and ELFTREE will invoke the format program you gave
to format the disk. (If you have not supplied ELFTREE with the
format program yet, then you will be requested to supply it at this
time before proceeding to format.) ELFTREE will not format a drive
that is not a floppy, so that you cannot use it to format a hard
disk inadvertently. After formatting, ELFTREE will resume copying
the files.
NOTE: When copying directories, ELFTREE will only copy those files
that match the current search specification (set with the F10
key) and attributes. You may want to change the
specifications before copying.
────────────────────────────────────────
COPYING TO MORE THAN ONE DIRECTORY
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
ELFTREE can copy one or more files to more than one directory
quickly and easily. Here's how:
1. Tag the files to copy (if more than one).
2. Select the Copy tool.
3. Tag each directory you want to copy them to.
4. Tap [Enter] to start copying.
────────────────────────────────────────
COPY TO SAME DIRECTORY ON TARGET DISK
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
To copy one or more files to a directory with the same name on a
different drive, just tap [Alt+drive] when asked which drive to
copy to. For example, to copy files in C:\WORK to A:\WORK, just
tap [Alt+A] when selecting the target disk (with the mouse, just
press down [Alt] and click on A).
────────────────────────────────────────
COPY TO CURRENT DIRECTORY ON TARGET DISK
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
To copy one or more files to the current directory on a different
drive, just tap [Shift+drive] when asked which drive to copy to
(with the mouse, just press [Shift] and click on the drive).
────────────────────────────────────────
EMPTY FILES OR THOSE WITH SPECIAL ATTRIBUTES
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
DOS will not copy files of zero length, and when it copies read-only
files, the newly created files will not be read-only. ELFTREE will
copy zero-length files and preserve any special attributes (hidden,
read-only, etc.) that may have been set. Some older programs use
this as a form of copy protection.
────────────────────────────────────────
SPECIAL CHOICES WHEN A FILE ALREADY EXISTS
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
If you are copying to a file that already exists, and have not given
ELFTREE blanket permission to overwrite it, then ELFTREE will ask you
what to do at that time. Your choices are as follows:
No - Don't Replace it
Yes - Replace it
Append - Add to the end of the file.
Edit - Edit the file that already exists.
Later - Replace the target files only if they are older
than the ones being copied or moved.
Overwrite - Replace this file, and give permission to
overwrite any others that may exist.
Rename - Rename the file (preserving both).
View - View the file that already exists.
To select one of these choices, either tap the letter of the option
or click on it with the mouse.
If the file you are about to overwrite is read-only, ELFTREE will
ask you for permission to remove this protection before proceeding.
If the target file is a directory or label, then ELFTREE will ask
you to rename it before proceeding.
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Directory Display █ Key: [D]
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
ELFTREE shows the directory structure on your disk in the shape of a
tree. This representation makes it easy for you to manage them with
a minimum of bother. If a note is attached to the file that stores
the tree, it is shown just below the path. If using a mouse, the
available drives are listed above the path.
Below is a list of helpful keys and a description of what you
can do while you are looking at the display of your directories:
────────────────────────────────────────
MOUSE FUNCTIONS
Menu Bar Click on a menu selection to activate it. For example, click
on Print to activate it.
Description Double-click to activate help for the highlighted menu item.
Drive List Click on a drive letter to change drives.
Current Path Click on Drive portion to change drives, click on path
portion to show the previous file information area.
? - Help Click to bring up a help screen of what keys are active.
Click on a key to simulate tapping it.
Tree Left-click to highlight a directory, right-click to tag or
untag a directory, double-click to simulate tapping [Enter]
for a directory. Click and hold down a mouse button to move
selection bar to another directory (they will be tagged or
untagged if the right mouse button is held down).
Left Edge Click on left edge of screen to simulate [Left] key.
Right Edge Click on right edge of screen to simulate [Right] key.
Miscellaneous If a box appears on the screen, clicking inside the box (but
not on any 'hot spot') usually does the same action as
tapping [Enter]. Clicking outside the box (but not on the
mouse toolbar) usually does the same as tapping [Esc] to
cancel an action.
────────────────────────────────────────
SOME SPECIAL KEYS
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
[Ctrl+Enter] Selects the highlighted item on the moving-bar menu.
[Enter] Selects the directory for display of files, then shows
the items in this directory. If copying/moving files,
this just selects the destination directory.
[Esc] Leaves the directory screen; displays files.
[#] Displays directory statistics (# of dirs, # hidden, # tagged,
#of files in them, total size of files).
[Space] Tags/Untags the highlighted directory, updating the combined
size of the files affected, and moves down the column.
[Ctrl+V] For EGA adapters, this toggles between 25 and 43 line modes.
For VGA, this cycles among 25, 28 and 50 line modes.
[Ctrl+Right] Selects the next item on the moving-bar menu.
[Ctrl+Left] Selects the previous item on the moving-bar menu.
[F1] Brings up help on using Directories.
[F2] Displays current status of many ELFTREE settings.
[F4] Customizes the style of the tree.
[F5] Rescans the subtree from the currently highlighted directory.
[L] or [F6] Display directory tree for another disk.
or [Shift+disk]
[DEL], [F7] Remove highlighted directory and all empty subdirectories.
or [Ctrl+K] If Professional Mode is on, you can remove directories with
files in them as well.
[F8] Toggles whether the [Enter], [Right] and [Left] keys affect
the moving-bar menu selections.
[F9] Saves the current directory tree to disk.
[F10] Changes what files are used when you select move, copy,
graft or [Enter].
[C] Copy tagged directories to another disk.
[E] Exposes hidden subdirectories of the highlighted directory.
[W] or [F] Find a directory by name. (accepts non-DOS names, too!)
[Alt+Key] Search for a directory whose first letter matches `Key'. For
ex, [Alt+A] looks for the next one that starts with `A'.
[=] Searches for a directory name as you type it.
[G] Graft (attach) the tagged directories to another directory,
either on the same or another disk. The files can be
copied or moved. Great for reorganizing your directories
or moving some between nodes on a network!
[H] or [>] If directories are tagged, this hides them from view (they
are still visible from DOS). If none are tagged, this will
hide all directories that have not already been hidden that
appear to the right of the current column in the tree.
(You will be prompted to confirm this.)
[M] Move tagged directories to another disk.
[N] Make a new subdirectory of the one currently highlighted.
[O] or [<] Open Next Level - unhides (opens) the next column of
directories that were hidden with the Hide command.
[P] Print the directory tree as displayed.
[R] Rename the currently highlighted directory.
[S] Rebuilds the directory tree for the current disk.
[T] Tag the highlighted directory and all subdirectories.
[U] Untag the highlighted directory and all subdirectories.
────────────────────────────────────────
MOVING AROUND THE TREE
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
To navigate around the tree display, use these keys:
[Right] Moves to the first directory below the current one in the next
column. If none, it moves to the next one in the same column.
[.] [Ctrl+P]
or [Left] Moves to the parent of the current directory.
[Up] Moves to the previous directory in this column.
[Down] Moves to the next directory in this column. If none, goes
one column to the right, if possible.
[Home] Moves to the first (root) directory.
[End] Moves to the last visible directory.
[PgDn] Moves to the last directory on the screen, then to the next
screen.
[PgUp] Moves to the first directory on the screen, then to the
previous screen.
[Plus] or [+] Highlights the next directory in the tree. When you reach
the end, it starts over at the first directory.
[Minus] or [-] Highlights the previous directory in the tree. When you
reach the beginning, it starts over at the last directory.
────────────────────────────────────────
TREE WIDTH
▀▀▀▀▀▀▀▀▀▀
ELFTREE is sensitive to the length of directory names. Shorter
names yield a tree with narrower columns than one with longer names.
Thus, more columns of directories are displayed if you keep these
names short. (When determining the width of the tree columns, only
visible directories are used. So, you can make ELFTREE see only
short names by Hiding the ones with long names.)
────────────────────────────────────────
[Del], [F7] ERASE DIRECTORY
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
Once you've deleted all of the items in a directory, you can delete
the directory itself by tapping the [F7] or [Del] key or clicking on
Del. If successful, the directory tree is updated to reflect the
change. If not, you still have files (or nonempty subdirectories)
still in the directory. Check the file search specification ([F10]
key) to see if it includes all possible files. If subdirectories are
still attached to the directory, they will appear to the right of it.
You will have to delete the files in these directories before you can
delete the 'parent' directory.
────────────────────────────────────────
[C, M] COPY/MOVE DIRECTORIES
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
To copy or move one or more directories, just tag them and tap [C]
or [M] (or click on Copy or Move). Next, indicate what disk to copy
or move them to, and let ELFTREE do it. The files will be copied
or moved to directories with the same name on the target disk.
With a mouse, right-click on a directory to tag or untag it. Drag
the mouse cursor while holding down the right button to extend the
operation as it is moved.
────────────────────────────────────────
[E] EXPOSE DIRECTORY
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
Tap [E] or click on Expose to reveal one or more hidden child
directories of the currently highlighted directory.
────────────────────────────────────────
[F] FIND DIRECTORY, Part I
▀▀▀▀▀▀▀▀▀▀▀▀▀▀
To find a directory of a given name, you can search for it by tapping
[F] or [W] or clicking on Find. You will be prompted for the name
to look for (non-DOS names can be used), then ELFTREE will highlight
the next directory that matches what you entered. For example, to
find a directory called TREE, you could search for it by typing TR*.
ELFTREE would find TREE, of course, but it would also find TROUBLE,
TRACK, and other directories that begin with TR. After finding a
directory, ELFTREE asks if it should keep looking. If you have the
one you want, tap or click on [Enter] to select it, or tap or click
on [Esc] to quit searching.
This is especially handy when looking at a tree display of a
disk with many directories. Using it will help you find the
directory you want quickly.
[=] FIND DIRECTORY, Part II
▀▀▀▀▀▀▀▀▀▀▀▀▀▀
Another quick way to find a directory is to have ELFTREE search for
it as you type its name! To activate this, tap the [=] key once.
In the space provided, type the name of the directory you are looking
for. As you type the name, the next directory that matches it will
be highlighted automatically. Tap or click on [Down] or [Up] for
the next or previous match, respectively.
────────────────────────────────────────
[G] GRAFT DIRECTORY
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
To graft one or more directories onto another, just tag them and
tap [G] or click on Graft. Next, specify whether the directories
should be copied or moved during the grafting process, and what disk
to graft the directories onto (you can graft them onto any disk,
including the current one). You'll then be shown a directory tree
for the target disk. Highlight the directory you want to graft onto,
and tap [Enter] to select it and begin the grafting process.
Here's an example. Suppose I tag five directories to graft:
C:\ ─────┬ DUMMY1 ──┬ A
│ ├─ B ───────┬ C
│ │ └ D
│ └─ E
├─ DUMMY2 ──┬ 1
│ ├─ 2
│ └─ 3
└─ DUMMY3
Next, I'll specify that I want these directories moved, that I want
drive C, and I'll select DUMMY3 as the target directory. This is
what the tree will look like after the grafting is done:
C:\ ─────┬─ DUMMY1 ──┬─ B
│ └─ E
├─ DUMMY2 ──┬─ 2
│ └─ 3
└─ DUMMY3 ──┬─ DUMMY1 ──┬─ A
│ ├─ C
│ └─ D
└─ 1
Notice that, even though DUMMY1 was not able to be removed (it
has child directories of B and E), all of the files that it held
have been moved to the DUMMY1 child of DUMMY3 (assuming here that
the filespec used was *.*). Notice, too that directories C and D
are now attached directly to DUMMY1 instead of to B.
You can see that grafting directories is a quick way to redo the
directory structure of a disk. With ELFTREE, you can graft onto
another disk, which is especially handy on networks.
────────────────────────────────────────
[H,<] HIDE DIRECTORY
▀▀▀▀▀▀▀▀▀▀▀▀▀▀
To hide one or more directories, just tag them and tap [H] or [<] or
click on Hide. The tagged directories will be immediately removed
from view (they still exist, and can be seen from DOS, but are just
not shown). To expose them again, move to their parent directory
and tap [E] or click on Expose.
To hide all directories to the right of the column you are currently
in, don't tag any directories - just tap [H] or [<] or click on Hide.
You will be asked if you want to hide all directories to the right
of the current column. To do so, select [Enter] or [Yes]. To not,
tap [Esc] or [N]. To open up the next column of directories that
have been hidden in this way, tap [O] or [>]. (This will not display
directories that have been hidden after tagging, as described in the
preceding paragraph. For this, tap [E] or click on Expose while
highlighted the parent directory.)
────────────────────────────────────────
[N] NEW DIRECTORY
▀▀▀▀▀▀▀▀▀▀▀▀▀
To create a new subdirectory, just highlight the directory you want
to be its `parent' and tap [N] or click on New. You will be prompted
for a name to give this `child'. Just type the name, and let ELFTREE
make it. If successful, ELFTREE will show the updated tree with the
new directory in it (if it fits on the screen, of course).
────────────────────────────────────────
[P] PRINT TREE
▀▀▀▀▀▀▀▀▀▀
To print the current directory tree, simply tap [P] or click on Print
when you are looking at the tree, and it will be printed immediately.
To see how much space is used by files in one or more directories,
simply tag the directories to be checked and tap [Y] or click on Yes
when asked to show the space used by each tagged directory.
────────────────────────────────────────
[F4] CHANGE TREE STYLE
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
Tap or click on [F4] to change the characters used to show the tree.
This may be needed if your printer has a difficult time trying to
draw the tree (for example, you might get letters instead of lines).
────────────────────────────────────────
[S] SCAN DISK
▀▀▀▀▀▀▀▀▀
Sometimes, such as after copying directories to another disk or
inserting a new floppy disk into your machine, you may need to rescan
a disk to regrow the tree. Simply tap [S] or click on Scan to start
the process, wait a few seconds for it to complete, and ELFTREE will
display the tree.
To grow only the portion of the tree beginning with the highlighted
directory, tap or click on [F5] instead of [S] or Scan.
If you have told ELFTREE to exclude files with certain attributes
from the display, then any directories with these attributes
will likewise be excluded when the disk is scanned. ELFTREE
is respecting your wish for privacy for these directories.
ELFTREE will automatically initiate a scan of your disk if you
ask to bring up the tree display while in a directory that was
not created with ELFTREE. This is a convenience, so that ELFTREE
can give you up-to-date disk information.
When ELFTREE builds a new tree by scanning the disk, it reveals
all directories that were formerly hidden through use of Hide, as
described above. Simply tag them and select Hide to hide them again.
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Editing A File █ Key: [E]
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
ELFTREE comes with an editor (ELFEDIT.EXE) that provides the
functions and simplicity you need. With it, you can use block
commands of copy, cut, paste, print, and save, and can convert
a block to UPPER, Proper and lower cases instantly! The editor
has support for EGA/VGA displays, 11 keyboard macros for complex
editing tasks, adjustable TAB stop settings and a host of other
niceties. Best of all, this editor is designed to work not just
on one file, but as many as will fit into memory! This lets you
transfer your work from one file to many others with speed. You
will love it, we're sure.
The editor can handle large files - even 500,000 bytes, and a line
length of up to 20,000 bytes (the defaults are 65,500 and 1,000),
but you can change this. Here's an example of how to command it to
use only 5,000 bytes per file, with a line length of 2,000 bytes:
ELFEDIT /M=5000 /L=2000
Of course, you can use the editor from the DOS environment as
well, and there is one distinct advantage to doing so, namely,
you can specify which files to edit by using wildcards. Here's
how to load a number of .BAT and .PRG files at once, using only
10000 bytes per file:
ELFEDIT *.BAT *.PRG /m=10000
The number of files ELFTREE can edit simultaneously is determined
by the size of the editing buffer you select with the /M=#####
command-line parameter. If you specify an editing buffer of
500000 bytes, then you'll only be able to edit one file. If you
choose a buffer size of 10000 bytes, you'll be able to edit dozens
of files. If you are not sure how much memory you have available,
use ELFTREE's Space command to tell you.
Here is a list of 12 features available to you in the editor:
1. Edit large/multiple files - depending on available memory.
2. FAST Block functions - Copy, Delete, Paste, Print, Save, Convert
to UPPER/Proper/lower case, Print Mailing Labels.
3. FAST Column Block functions - Copy, Delete or Paste.
4. FAST Search and Replace - replace a phrase with another. You
can confirm each selection, change just one occurrence, or
change all of them. Also, you can count the number of times
a word or phrase occurs in the file.
5. Merge File - Insert a file into the one currently being edited
at the cursor position.
6. Instant Key Help - Tap [F1].
7. Delete/Copy/Paste single lines quickly.
8. FAST loading - the editor is small, so it loads very quickly,
and any file you load displays immediately.
9. FAST Cursor Operations - Immediate Page Up, Page Down, etc., no
matter how fast your cursor is.
10. Keyboard Macros - Create and store up to 11 macros for complex
repetitive editing chores.
11. Customizability - Customize the video mode (supports 25/43
lines for EGA, 25/28/50 for VGA), the colors, the tabstops,
autosave, and backup of files.
12. Load a new file into a fresh buffer - if there is room - or
jump to any file currently loaded.
────────────────────────────────────────
USING ANOTHER EDITOR
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
Of course, it's okay if you have another editor you prefer. To
use your editor from within ELFTREE, you have to tell ELFTREE how
to find it. Tap [F4] for the Customize options, and select [K] for
Editor Path. Enter the complete name (with path, if known), any
parameters you want included with each invocation, whether it needs
lots of memory, and what key it uses for the command [Go To Line #].
Notes: You may use ELFTREE's macro symbols among the parameters.
The [Go To Line #] key is only used if you tap [E] while
viewing a file with line numbers active, and makes the editor
start at the line currently shown at the top of the viewer.
(Be sure to save [F9] your configuration before leaving ELFTREE, so
this information is remembered.)
────────────────────────────────────────
INVOKING THE EDITOR
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
Once you tell ELFTREE the name of your editor, and what parameters
you want to use with it (macro symbols can be used), it is available
for use by selecting EDIT from the menu bar. (Tap [E], or
highlight EDIT and tap [Enter].)
────────────────────────────────────────
EDITING MULTIPLE FILES
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
To edit multiple files, just `tag' the files you wish to edit,
and select the `Tagged' submenu option under `EDIT'. ELFTREE
will supply the names of the tagged files (up to 115 bytes,
counting the spaces between the names, if in list form).
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Finding Files █ Key: [F]
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
Ever wish you could work with files from dozens of directories and
on several disks as if they were in one? For example, you might
want to locate all of those files relating to a particular project
so you can copy them to a floppy, or transfer them to someone else
across the network. With ELFTREE, this is easy. The Find menu
selection makes this possible.
Notes: To quickly gather all files on all non-floppy drives that match
the current file specification, tap or click on [Ctrl+F10] or [F11].
To quickly find a file in the current list, tap the [=] key once,
then type its name in the space provided. As you type the name,
ELFTREE will highlight the next file that matches it (if any).
Tap or click on the [Down] or [Up] key for the next or previous
match, respectively.
Networked users should set the ETDRIVES environment variable so that
ELFTREE will know which drives to search when looking for files.
Here's an example of how to set it to search drives C, D, E and F:
SET ETDRIVES=CDEF
────────────────────────────────────────
DATE
▀▀▀▀
This gathers a group of files within a range of dates. To activate
it, select Find Date from the menu bar. Enter a pair of dates for
ELFTREE to use when it builds the table of files - only files whose
dates are between the ones you supplied will be included.
Next, enter a range of filespecs to look through, indicate any special
attributes to include, and specify what disks to search on.
Finally, if only one disk is chosen to search, ELFTREE will ask if
you want to search all of the directories on the disk (for example,
you may only want to search one subtree). If you choose No, you'll
be asked to tag the directories you want to search, and ELFTREE will
only search these directories. Otherwise, ELFTREE will look through
all of the directories on the disk, grabbing all of the files
matching these specifications.
Note: To find all files with a particular date, just type the same
date twice to make the pair.
────────────────────────────────────────
GLOBAL
▀▀▀▀▀▀
This gathers a bunch of files that match a group of filespecs you
want to search for. To activate it, select Find Global from the
menu bar. You'll be asked to enter the filespecs to look for (feel
free to use non-DOS names like *ABC* here, or to put multiple specs
on the line, separated by colons), and the file attributes you are
interested in. Next, tell ELFTREE what disks to look on - include
network drives if you wish them to be searched as well.
Finally, if you chose only one disk to search, ELFTREE will ask if
you want to search all of the directories on the disk (you may only
want to search a particular subtree, for example). If you choose
No, you'll be asked to tag the directories you want searched, and
ELFTREE will only search these directories. Otherwise, ELFTREE will
look through all of the directories on the disk.
For Example
▀▀▀▀▀▀▀▀▀▀▀
For example, to find all files that begin with ELF, or have the
letters ELF in the name, you would tell ELFTREE to look for:
ELF*.*:*ELF*
This would match ELFTREE.CHL, BELFRY, etc.
As ELFTREE searches for the files, it tells you which directory
and disk it is currently looking in. When it completes the
search, it displays the files that it found. (If it didn't find
any, you'll be returned to what you had previously.)
WHAT CAN YOU DO NOW?
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
From the display, you have access to ALL of ELFTREE's usual tools!
So, you can tag several files, copy or move them to a particular
directory or disk, dupe them, edit them, erase them, print them,
rename them, view them, etc. Just use the tools provided to get
the job done.
────────────────────────────────────────
LOAD
▀▀▀▀
If the highlighted file is a list of files that was saved using the
Find Save command, Find Load will load it and show the files.
────────────────────────────────────────
MERGE
▀▀▀▀▀
If the highlighted file is a list of files that was saved with the
Find Save command, Find Merge will merge the stored files with the
ones you are currently working with (or load them if none are
already loaded).
────────────────────────────────────────
PREVIOUS
▀▀▀▀▀▀▀▀
When you select Find Date, Find Global, or Find Text for a search,
ELFTREE automatically stores the file information it finds in a
file called LASTFIND.ETG. Find Previous loads this list.
────────────────────────────────────────
REFRESH
▀▀▀▀▀▀▀
When working with a saved selection of files, the information
in them may get stale with age, as files get moved, changed,
erased, etc. Find Refresh updates the information kept for each
file currently loaded, and removes those that no longer exist
where they once did. If you wish to only refresh a few files,
just tag them before selecting this tool.
────────────────────────────────────────
SAVE
▀▀▀▀
Find Save saves the current file display for later use. If you are
working on a global list of files, the file will be saved, with the
extension .ETG, either to the directory where ELFTREE is stored or
in the directory specified by the environment variable ETFIND.
If you are working on a local list of files, this will be saved with
an extension of .ETL to the current directory.
To make such a file of files auto-loading when ELFTREE starts up,
simply use a filename of AUTOET. Such a file is used by ELFTREE
if it saves your files before running a program, and is erased
when it starts up again.
────────────────────────────────────────
TEXT
▀▀▀▀
Find Text gathers files that have a specific piece of text in them.
You'll be asked to enter the text to search for, and whether to look
only through files in the current directory.
If you specify the current directory, it will either search the
highlighted file, if none are tagged, or all of the tagged files.
When it finds a file that has this text, it `retags' it, otherwise
it `untags' it.
If you specify a broader search scope, you will be asked for a group
of filespecs to search through, then the attributes to include
(Directory has no meaning here). Next, you'll be asked for the disks
to search on. By default, floppy drives are left out, but you can
add them now if you wish them searched. If you chose only one disk
to search, ELFTREE will ask if you want to search all of the
directories on the disk (you may only want to search a particular
subtree, for example). If you choose No, you'll be asked to tag the
directories you want searched, and ELFTREE will only search these
directories. Otherwise, ELFTREE will look through all of the
directories on the disk. When ELFTREE is done searching, it will
show all of the files that have this text in it, if any. If none
were found, you will be returned to directory you were in before you
started the search.
────────────────────────────────────────
ADJUSTING CAPACITY
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
You can adjust the number of directories and files ELFTREE will use
(5000 files, 50 directories is the default; up to 999 directories
and 16,384 files can be used) for the Find facility. Here's an
example of how to start up ELFTREE so that it uses 1000 files and
100 directories:
ET /F=1000 /G=100
You must tap or click on [F9] if you want this kept for the next
time you start up ELFTREE.
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Moving Files and Directories █ Key: [M]
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
You can move one or many files (even entire directories) with
ELFTREE, and with far fewer keystrokes than DOS. Also, since
ELFTREE will move files to other disks (or other machines on a
network), you have much more capability than DOS gives you.
If you have a note attached to a file, the note will be moved with
the file if there is no file with that name in the directory you
are moving to.
────────────────────────────────────────
HILIGHTED
▀▀▀▀▀▀▀▀▀
Assuming no files are tagged, you can move a file by selecting the
Move command from the menu bar (tap [M] or click on Move). If files
are tagged, a submenu will appear - select Highlighted from this.
Next, find the drive and directory to move the files to (or make a
new directory, if needed), tap [Enter] or double-click on it, and sit
back and let ELFTREE move it.
────────────────────────────────────────
TAGGED
▀▀▀▀▀▀
After tagging the files to move (by tapping [Space], using the Tag
menu command or right-clicking on them with the mouse), move them by
selecting Move Tagged from the menu bar. Next, find the directory
to move the files to (or make a new one, if needed), tap [Enter] or
double-click on it, and sit back and let ELFTREE move the files.
If you don't want ELFTREE to ask for permission about replacing
files that may exist in the target directory before starting to move
the tagged files, change the Copy Overwrite option in the Advanced
Switches submenu under Customizing. Be careful, though - you may
replace files you didn't intend to replace!
────────────────────────────────────────
MOVING ENTIRE DIRECTORIES
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
ELFTREE can move entire directories from one disk to another. To do
this, you must be looking at the directory tree (tap [D] or click on
DirTree to get to it). Now, tag the directories you want moved.
Here's how to tag them:
1. Tap [Space] to tag an individual directory.
2. Right-click on a directory touched with the mouse pointer.
3. Tap [T] or click on Tag - to tag the current directory and all
of its subdirectories. (Hint: to tag all directories on a
disk, move to the root directory before selecting Tagged.)
4. Tap [U] or click on Untag - to untag the current directory and
all of its subdirectories.
Now, tap [M] or click on Move, tell ELFTREE what disk to move to,
and sit back and let ELFTREE move the directories.
If you elect to move the directories to another disk, then
ELFTREE will copy the files and, if successful, will erase the
originals. As ELFTREE copies files, it checks to see if there's
enough room on the disk to store the copy. If there isn't, and
you are copying to a floppy, ELFTREE will tell you there is not
enough room to copy the file, and will let you Skip the file, put
in a fresh disk and Continue, or Quit copying altogether. If you
put in a disk that has not been formatted, ELFTREE will give you an
error message (such as "Unreadable disk in Drive A"), and then ask
if you want to format the disk right now. Just answer
`Y' to format it, and ELFTREE will invoke the format program you
specified to format the disk. (If you have not supplied ELFTREE
with the format program yet, you will be requested to supply it
at this time before proceeding to format.) ELFTREE will not
format a drive that is not a floppy, so that you cannot use it to
format a hard disk inadvertently. After formatting, ELFTREE will
resume moving the files.
After moving the directories, ELFTREE attempts to remove any
empty tagged directories from the tree.
NOTE: When moving directories, ELFTREE will only move those
files that match the current search specification (set
under the [F10] key) and attributes. You may want to
change the specifications before moving.
────────────────────────────────────────
MOVING TO MORE THAN ONE DIRECTORY
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
ELFTREE can move one or more files to more than one directory
quickly and easily. Here's how:
1. Tag the files to move (if more than one).
2. Select the Move tool.
3. Tag each directory you want to move them to.
4. Tap [Enter] to start moving.
────────────────────────────────────────
MOVE TO SAME DIRECTORY ON TARGET DISK
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
To move one or more files to a directory with the same name on a
different drive, just tap [Alt+drive] when asked which drive to
move to. For example, to move files in C:\WORK to A:\WORK, just
tap [Alt+A] when selecting the target disk (with the mouse, just
press down [Alt] and click on A).
────────────────────────────────────────
MOVE TO CURRENT DIRECTORY ON TARGET DISK
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
To move one or more files to the current directory on a different
drive, just tap [Shift+drive] when asked which drive to move to
(with the mouse, just press [Shift] and click on the drive).
────────────────────────────────────────
EMPTY FILES OR THOSE WITH SPECIAL ATTRIBUTES
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
DOS will not copy files of zero length, and when it copies read-only
files, the newly created files will not be read-only. ELFTREE will
move zero-length files and preserve any special attributes (hidden,
read-only, etc.) that may have been set. Some older programs use
this as a form of copy protection.
────────────────────────────────────────
SPECIAL CHOICES WHEN A FILE ALREADY EXISTS
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
If you are moving to a file that already exists, and have not given
ELFTREE blanket permission to replace it, then ELFTREE will ask you
what to do at that time. Your choices are as follows:
No - Don't Replace it
Yes - Replace it
Append - Add to the end of the file.
Edit - Edit the file that already exists.
Later - Replace the target files only if they are older
than the ones being copied or moved.
Overwrite - Replace this file, and give permission to
overwrite any others that may exist.
Rename - Rename the file (preserving both).
View - View the file that already exists.
If the file you are about to overwrite is read-only, ELFTREE will
ask you for permission to remove this protection before proceeding.
If the target file is a directory or label, then ELFTREE will ask
you to rename it before proceeding.
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Notes and Files █ Key: [N]
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
Ever need to attach a brief note to a file? It might be a short
description of what the file contains, of what still needs to be
done with the file (as a reminder), or whatever.
ELFTREE lets you attach a note or up to 52 characters to a file, to
erase a note attached to a file, or to search for files whose notes
contain a string you are looking for. (One caution, however. You
can only use the Note tool when working with one directory of files.)
To make ELFTREE display the notes next to the files/directories
they belong to, tap the [Tab] or [Shift+Tab] key to step through
the file display until the notes appear.
────────────────────────────────────────
ADD OR EDIT A NOTE
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
Choose Note Add to attach a note to the currently highlighted file,
or to edit one that has been attached to it. After typing the note,
tap or click on [Enter] to keep it.
To attach notes to more than one file, just tag them first.
To copy a note to another file, choose Note Add and tap [Alt+C] to
copy the note to a note clipboard. Then, move to the file you want
to attach it to, select Note Add, and tap [Alt+P] to paste it.
────────────────────────────────────────
ERASE A NOTE
▀▀▀▀▀▀▀▀▀▀▀▀
Choose Note Erase to erase a note that is attached to the currently
selected file. To remove notes from more than one file, just tag
the files whose notes are to be deleted.
────────────────────────────────────────
FIND A NOTE
▀▀▀▀▀▀▀▀▀▀▀
Once you've added dozens of notes to your files, you may need help
locating a particular note. That's what Note Find is designed for.
After selecting the tool, type the text to look for. ELFTREE will
look through all of the notes it has for the directory, and will tag
those files where the note has that text.
────────────────────────────────────────
FOR 4DOS OR PROFINDER USERS
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
If you use 4DOS or ProFinder, you may be aware that they have
facilities to attach notes to files. ELFTREE can use these note
files instead of creating duplicate ones, but you won't be able
to save a note longer than 40 characters. To enable 4DOS-style
notes, make the Note Type setting in the Miscellaneous Settings
submenu of Customization to 4DOS. For ProFinder-style notes,
select a setting of ProF. Also, be sure to use the command-line
switch /N=#### to tell ELFTREE the maximum number of notes to
reserve space for.
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Printing With ELFTREE █ Key: [P]
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
You can print the contents of one or many files, the current list
of files in the file information area, or a picture of the directory
tree display for the current disk with ELFTREE.
────────────────────────────────────────
PRINT SETTINGS
▀▀▀▀▀▀▀▀▀▀▀▀▀▀
Before ELFTREE prints something (a file, the directory tree, a marked
block), you can tell it how you want the output to look. Here are
the settings you can configure, and what they mean:
Note: Clicking with the mouse in a particular field moves the cursor
to that field immediately.
PRINT AS IS
▀▀▀▀▀▀▀▀▀▀▀
To make ELFTREE print exactly what's in the file, without converting
tabs, printing the filename, paying attention to margins, etc., enter
`Y' in this field. If you are in Immediate mode, entering a `Y' will
proceed to print immediately.
INITIAL SETUP
▀▀▀▀▀▀▀▀▀▀▀▀▀
Sent just before each new page is started, the initial setup string
can be used to change the number of lines per inch for your printer,
to print in a particular typeface or a certain pitch, etc.
Note: To put the Escape character on the line for the setup string,
tap or click on [Alt+Z].
FINAL SETUP
▀▀▀▀▀▀▀▀▀▀▀
Sent after each file is printed, the final setup string can be used
to reset the printer to its former state.
PAGE HEADER
▀▀▀▀▀▀▀▀▀▀▀
Use Page Header to print something at the top of each page. Just
type it in the space provided. Note: the Top Margin must be at
least 2 for the page header to be printed.
LEFT MARGIN
▀▀▀▀▀▀▀▀▀▀▀
Enter a number to indicate the number of character positions you
wish each line to be indented by.
RIGHT MARGIN
▀▀▀▀▀▀▀▀▀▀▀▀
Enter a number to indicate the last position a character may be
printed on a line. A line that is longer than what is allowed by
the Left and Right margin settings will be split, with the balance
of the line appearing on subsequent lines, as needed.
TOP MARGIN
▀▀▀▀▀▀▀▀▀▀
Enter a number to indicate the number of blank lines to put at the
top of each page printed.
BOTTOM MARGIN
▀▀▀▀▀▀▀▀▀▀▀▀▀
Enter a number to indicate the number of blank lines to put at the
bottom of each page printed.
PAGE LENGTH
▀▀▀▀▀▀▀▀▀▀▀
Enter a number to indicate how many lines can be put on a page. For
example, if your printer is set for 6 lines per inch, and you are
using 11 inch long paper, then use 66 here. The number of text lines
printed is this number minus the number of lines used for the top
and bottom margins.
CHANGE TABSTOP
▀▀▀▀▀▀▀▀▀▀▀▀▀▀
By default, almost all printers expand tabs to the next tab stop,
which are usually 8 positions apart. If you wish for ELFTREE to
choose a different tab separation, enter a number indicating what
you wish for the new tab setting.
Clicking with the mouse cycles forward to the next setting.
Note: If you are printing a file that was printed to disk from your
word processor, we recommend a setting of 0, as the file most likely
contains its own margin settings. We also recommend that you enter
a `Y' for the Print As Is selection.
PRINT FILENAME
▀▀▀▀▀▀▀▀▀▀▀▀▀▀
When you print a file, you may wish the name of the file to appear
at the top of each page. If so, enter a `Y' in this box, otherwise
enter `N'. Note: the Top Margin setting must be at least 2 for this
to have an effect.
Clicking with the mouse toggles between Y' and 'N'.
LINE NUMBERS
▀▀▀▀▀▀▀▀▀▀▀▀
If you wish ELFTREE to put line numbers in front of each line that
it prints, enter a `Y' for this. Be sure that you enter a value
for the Left Margin that will allow sufficient room for the numbers
to be printed, otherwise this option is ignored! ELFTREE will
print line numbers up to 4 billion plus.
Clicking with the mouse toggles between Y' and 'N'.
PRINTER PORT
▀▀▀▀▀▀▀▀▀▀▀▀
Enter `1' to select parallel port LPT1, `2' for LPT2, '3' for LPT3,
'A' for COM1 or 'B' for COM2.
Clicking with the mouse cycles forward through these selections.
DESTINATION (P/F)
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
If you wish to print to the printer port specified, enter a `P'.
If you wish to print to a file, enter an `F' here, and enter a
filename for the file to be printed to in the next area.
Clicking with the mouse toggles between 'P' and 'F'.
PAGE START
▀▀▀▀▀▀▀▀▀▀
If you want to start printing beginning with a page other than 1,
enter the page in this area.
PAGE STOP
▀▀▀▀▀▀▀▀▀
To print only a portion of the text, specify what page to stop at
in this area.
PAGE STEP
▀▀▀▀▀▀▀▀▀
To print every page, use 1 in this area. To print every other
page, use a 2 here.
For example, to print every even page, starting with page 2, put
a 2 in the Page Start area, a sufficiently large number in the
Page Stop area, and a 2 in the Page Step area.
────────────────────────────────────────
PRINT ONE FILE
▀▀▀▀▀▀▀▀▀▀▀▀▀▀
To print one file, select Print from the menu bar if no files are
tagged and Print Hilighted if one or more are tagged (and not in
Immediate mode). Fill in the printer parameters, tap or click on
[F10], and ELFTREE will start printing. After the file is printed,
ELFTREE will send a form feed to the printer.
────────────────────────────────────────
PRINT SEVERAL FILES
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
To print more than one file, just tag the files to be printed and
select Print Tagged from the menu bar. Next, fill in the printer
parameters, tap or click on [F10], and ELFTREE will start printing.
A form feed will be sent to the printer after each file.
────────────────────────────────────────
PRINT DIRECTORY LISTING
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
To print the current directory listing, just select Print Listing
from the menu bar. Fill in the printer parameters and the listing
will be sent to the printer in the order currently displayed. You
may want to Sort [F2] it and Rearrange [F5] it before printing.
If files are tagged, ELFTREE will ask you if you want to include
only the tagged files when it prints the listing. If any of the
files have a note attached, the note will appear as well.
────────────────────────────────────────
INTERRUPT PRINTING
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
Tap or click on [Esc] to interrupt ELFTREE while it is printing.
Then, tap [R] or click on [Resume] to resume, or tap [Esc] or click
on [Cancel] to quit.
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Renaming A File Or Directory █ Key: [R]
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
You can rename one or many files listed in the file information
area, or a disk volume label. In addition, if you have DOS 3.X
or later, you can rename directories with ELFTREE.
────────────────────────────────────────
RENAME ONE FILE
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
To rename one file, just highlight it and select Rename (Rename
Hilighted if files are tagged and not in Immediate mode). In the
box provide, enter the new name for the file then tap or click on
[Enter]. ELFTREE will not re-sort the file information area when
you rename a file, but you can force it to do this by tapping or
clicking on the Sort [F2] key, then [Enter].
────────────────────────────────────────
RENAME SEVERAL FILES
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
To rename more than one file, just tag them and select Rename Tagged
from the menu bar, and ELFTREE will feed them to you for renaming,
one by one. If you want to use a pattern to rename all of the tagged
files, just type in the pattern (it must either use DOS wildcards, or
begin with a period, to be recognized as a pattern by ELFTREE) you
want to use for the first file. ELFTREE will sense the pattern and
will ask if you want to use this pattern to rename the rest of the
files. Tap [Y] or click on [Yes] if you want the rest of the files
to be renamed using this pattern.
────────────────────────────────────────
RENAME A DIRECTORY
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
To rename a directory, just highlight it (directories cannot be
tagged), select Rename, enter the new name for it, and tap or click
on [Enter]. ELFTREE will rearrange the directory tree display, if
needed, so that the directories are still in alphabetical order.
This saves you the effort of rescanning the disk to rebuild the
directory structure. You can rename a directory from the file
display or from the tree display.
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Disk, RAM Space Usage █ Key: [S]
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
When you want to know how much space is in use by your system,
either on a disk or in memory, the Space command will tell you.
Select Space from the main menu, and enter the disks you would
like information to be reported for. (The default is to present
a list of all non-removable drives in your system.)
The displayed information will look something like this:
█████████████████████Disk Space and/or Memory Usage█████████████████████████████
█Disk Remaining Used Total Pct Usage Indicator Tag Size Type█
█ █
█ C: 104,294K 29,626K 133,921K 22% ▒▒▒▒░░░░░░░░░░░░░░░ 9,490K L █
█ █
█ D: 101,755K 32,166K 133,921K 24% ▒▒▒▒░░░░░░░░░░░░░░░ 9,490K L █
█ █
█ E: 105,183K 28,738K 133,921K 21% ▒▒▒░░░░░░░░░░░░░░░░ 9,490K L █
█ █
█ F: 218,906K 40,038K 258,712K 15% ▒▒▒░░░░░░░░░░░░░░░░ 10,531K L █
█ █
█Sum: 529,906K 130,568K 660,474K 19% ▒▒▒▒░░░░░░░░░░░░░░░ █
█ █
█Conventional Memory: 655,360 installed, 337,712 free CDROM = C █
█ Extended Memory: 15,729K installed, 14,090K free Local = L █
█ Expanded Memory: (none) installed, (none) free Network = N █
█ CPU Type: 80486 Removable = R █
█ Tap a key to continue █
████████████████████████████████████████████████████████████████████████████████
Note: If any number in this chart ends with 'K', then the number has
been rounded to the nearest thousand. If a number ends with 'M',
the number has been rounded to the nearest million (1,000,000).
Here is an explanation of what each column contains:
1) Disk - Drive letter being reported on.
2) Remaining - Number of bytes available for use on this disk.
3) Used - Number of bytes already in use on this disk by
directories, files and system structures.
4) Total - The number of bytes that the disk can hold.
5) Pct - Percentage of total disk space that is in use.
6) Usage Indicator - a graphic picture of how much of the disk's
capacity has been used.
7) Tag Size - How much space the tagged files would occupy on
the disk. This number will vary depending on the
cluster size of the disk.
8) Type - Type of disk (CDROM=C, Local=L, Network=N).
Below the disk information are the following rows:
A) Sum - Has totals for each column of disk information.
B) Conventional Memory - How much memory is installed in your
system (up to 640K or 655,356), and how much is of this
memory is available for use.
C) Extended Memory - How much memory is installed in your
system above 1 Megabyte, and how much is of this
memory is available for use (usually as XMS memory).
D) Expanded Memory - How much memory in your system is
managed by an expanded memory manager (v3.2 or v4.0),
and how much is available for use. (Some expanded memory
managers manage both XMS and Expanded memory from the
same pool, so these numbers may be identical to C).
E) CPU Type - The type of CPU detected in your system.
Together, these figures will help you stay on top of how much
disk space your current applications are using on your disk.
This will help you to decide when to remove them from the disk,
or upgrade the capacity of the disks on your system.
To see how much space is used by files in one or more directories,
tap [D] or click on DirTree to show the Directory Tree, tag the
directories to be checked, and tap [Y] or click on [Yes] when asked
to show space used by each tagged directory.
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Tagging Files █ Key: [T]
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
ELFTREE can perform many of its operations on either one file
or several. The mechanism by which you tell ELFTREE which files
to use for your next operation is called TAGGING, and there are
many ways to do it. After you have learned how to tag files,
you are ready to discover the real power of ELFTREE. By tagging
files, you can instruct ELFTREE to work with a diverse group of
them with just a couple of keystrokes.
────────────────────────────────────────
TAG HIGHLIGHTED FILE ONLY
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
If the currently highlighted item in the file information area is a
file, you can tag it by tapping [Space]. When you do this, a ''
symbol will appear to the left of the file name, and the totals for
tagged files at the bottom will change to reflect your action. To
untag a file, just highlight it again and tap [Space]. This will
remove the `', and the totals will change accordingly.
With a mouse, right-click on a file to tag or untag it. Drag the
mouse cursor while holding down the right button to extend the
operation as it is moved.
Note: Directories cannot be tagged. When the highlighted item is a
is a directory and you tap [Space], the highlight moves to
to the first file after the directory, if possible.
────────────────────────────────────────
To tag or untag more than a few files, use the TAG menu selection
to reveal some additional choices. Here is a description of each:
────────────────────────────────────────
ALL
▀▀▀
Tag All will 'tag' all files in the file information area.
────────────────────────────────────────
DIFF
▀▀▀▀
Tag Diff will compare the files in this directory to the one in the
last directory you were in, and will `tag' those files that are not
identical. You will be asked whether you want the files compared by
bytes, which takes longer, or by properties, which just compares the
sizes and date/time stamp. Tap [S] or click on [Slow] for the slower
operation, or tap [F] or click on [Fast] for the faster one. If you
choose [Slow], you must tag the files you want compared if you want to
compare more than one.
After comparing each pair of files, the file in the current directory
is either tagged, retagged, or untagged, according to whether the
file in the other directory is different, does not exist, or is
found to be identical, respectively.
The keystroke sequence [Ctrl+F8] also activates this feature.
────────────────────────────────────────
DUPE
▀▀▀▀
Tag Dupe appears only if you use Find to gather files from different
directories. It will `tag' those files that have the same name as
another file (or directory) in the list. To move among the duplicate
file names, tap the '>' and '<' keys (these are specially designed
to move among tagged files).
The keystroke sequence [Ctrl+F8] also activates this feature.
────────────────────────────────────────
GROUP
▀▀▀▀▀
Tag Group will let you specify one or file name patterns for tagging.
Here are some examples:
*.EXE - tags all files with an extension of `.EXE'
TR*.* - tags all files that begin with `TR'
BA*.PAS - tags all files that begin with `BA' and have
an extension of `.PAS'
???.* - tags all files that have three letters in their
filename and may or may not have an extension.
*A*B* - tags all files with an 'A' and a 'B' in the name,
with the 'B' following the 'A'.
────────────────────────────────────────
HIGH
▀▀▀▀
Tag High will `tag' all of the files above the highlight bar, but
will not tag the highlighted file. This is handy, for example, when
the files are sorted by date/time, and you want to tag all of the
files that are before or after a certain date.
────────────────────────────────────────
INVERT
▀▀▀▀▀▀
Tag Invert will cause all tagged files to become untagged, and all
untagged files to be tagged. This is most useful when you want to
tag all but a few of the files in the current directory. In this
scenario, you would tag the files you DON'T WANT, then choose Tag
Invert. Presto! The files you do want are now tagged.
────────────────────────────────────────
KEEP
▀▀▀▀
Tag Keep will restrict the file display to only those files that are
tagged. For example, you may wish to work with files relating to a
particular project, and no others. To do this, just tag the files
you want kept for the display and select Tag Keep. If you wish to
save this file list, choose Find Save. As another example, if you
have previously done a Tag Dupe to mark files with duplicate names,
Tag Keep will drop all others from the group.
────────────────────────────────────────
LOW
▀▀▀
Tag Low will tag the files below and including the highlighted one.
This is handy, for example, when the files are sorted by date/time,
and you want to tag all of the files that are before or after a
certain date.
────────────────────────────────────────
NOTES
▀▀▀▀▀
Tag Notes will tag all files in the list that have a note attached
to them.
────────────────────────────────────────
RETAG
▀▀▀▀▀
After ELFTREE performs an operation on one or more files, it puts a
small `o' in front of it where the `' was. This tags the files
again, which includes them in the next group operation.
────────────────────────────────────────
UNTAG
▀▀▀▀▀
Tag Untag will untag some or all of the files in the file information
area. If you have one or more files tagged (denoted by a solid
diamond), and others are retagged (denoted by a hollow circle), then
ELFTREE will just clear the tags off of the ones marked with the
diamond. If no files are tagged, then all of the retag symbols will
be cleared. This two-step process lets you isolate the files that
are retagged for a particular operation. As an example, you might
use the Tag Diff selection to compare two directories, which leaves
some files tagged (which means they are in both but are not identical)
and others retagged (which means that they are not in the other
directory at all). By clearing the tagged files, you can then use
Tag Retag to select the files that did not exist in the other
directory, then use Copy Tagged to copy them over to it.
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Viewing A File █ Key: [V]
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
ELFTREE can show you the contents of any file on your disk, no
matter how large it is. This is handy when you need to take a
peek inside a file, but your editor cannot handle it. For
example, you might want to look at the documents in your word
processing directory to see which ones were memos to your boss.
────────────────────────────────────────
VIEWING MODES
▀▀▀▀▀▀▀▀▀▀▀▀▀
ELFTREE can display your file in one of these modes:
Hex - ASCII on the right, corresponding HEX on the left.
Normal - Filtering of carriage return/line feed pairs only.
High Bit Off - Only use lower 7 bits of each character.
Text&Graphics - Skip control characters (below 32).
Text Only - Skip control and graphics characters (above 126).
A-Z, a-z - Show alphabetic characters only.
In addition, you can select whether long lines of text should wrap
around when the screen border is reached. (When wrapped, a ruler
line appears just above the display area for your convenience.)
Note: Only text files can wrap; binary files cannot.
────────────────────────────────────────
ACTIVE KEYS
▀▀▀▀▀▀▀▀▀▀▀
These keys are available while viewing a file:
[Ctrl+V] For EGA, this toggles between 25 and 43 line modes. For
VGA, this cycles among 25, 28 and 50 line modes.
[A] Repeats search for text (top-to-bottom).
[Alt+A] Repeats search for text (bottom-to-top).
[B] Mark beginning/end of a block in the file.
[C] Change case used for text search.
[Shift+TAB],
[TAB],[D] Change text filter used for displaying file.
[E] Leaves viewer, invokes editor for this file.
[F] Initiates search for text (top-to-bottom).
[Alt+F] Initiates search for text (bottom-to-top).
[H] Toggles the HEX display filter.
[J] Jump to specific position in file being viewed.
[L] Toggles whether line numbers are shown or not.
[O] Toggles whether orphaned [CR] and chars are treated as
as end-of-line characters.
[R] Enter replacement text.
[Alt+R] Apply replacement text.
[T] Toggles whether tabs are expanded or not.
[U],[Alt+U] Replace replacement text with found text.
[W] Toggles wrapping of long lines.
[I], [Alt+I] Toggles translation from IBM EBCDIC to ASCII.
[Alt+1]-[Alt+8] Changes tabstop expansion to 1-8, respectively.
[+ or -] Increases or Decreases tabstop setting by 1.
[F5] Marks the file as a block and activates block menu.
[F8] Toggles whether the [Enter], [Right] and [Left] keys affect
the moving-bar menu selections.
[F9] Moves backward 1/3 page in the file.
[Ctrl+Left,
Ctrl+Right] Selects previous, next item on the moving-bar menu.
[Ctrl+Enter] Selects the highlighted menu item.
[Enter] same as above.
[Right] If Menu is active, highlights next menu item, otherwise
moves forward 1 byte in the file.
[Left] If Menu is active, highlights previous menu item, otherwise
moves backward 1 byte in the file.
[Up, Down] Moves backward, forward 1 line in the file.
[PgUp, PgDn] Moves backward, forward 1 page in the file.
[Home, End] Moves to beginning, end of file.
[Delete] Erases the file (after prompting).
[ < , > ] Views previous, next tagged file in the list.
[Ctrl+PgUp,
Ctrl+PgDn] Views previous, next file in the list.
────────────────────────────────────────
BRING UP EDITOR [E]
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
You can bring up your editor to work on the file you're currently
viewing by tapping [E] or clicking on Edit. This is handy if you
see a need for changes in the file you're viewing.
────────────────────────────────────────
CUSTOMIZABLE TAB STOPS [T,+,-]
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
If you regularly browse text files, you'll appreciate a special
feature of ELFTREE. You can tell ELFTREE whether to expand tabs to
selected tab stop settings or not and, if they are expanded, how far
apart the tab stops should be (from 1 to 8). If you program, this
makes it much handier to view listings. The current mouse setting
is in middle of the last screen line. Using the mouse, click on
[+] to increase the tabstop setting, and [-] to decrease it.
────────────────────────────────────────
FOR EGA and VGA DISPLAYS [Ctrl+V]
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
While viewing a file, you can advance or go backward one line at
a time (two if in hex display mode) or one screen at a time. You
can also change the display (if you have an EGA) to 43 line mode
from 25 line mode or vice versa. If you have a VGA, you cycle among
25, 28 and 50 line modes. (The keystroke [Ctrl+V] activates this.
Hold down the [Ctrl] key, tap [V] once, then release both.)
────────────────────────────────────────
AUTOMATIC SCROLLING [1..9]
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
You can scroll either forward or backward in your file at varying
speeds. To do this, tap either the UpArrow or DownArrow keys
(this tells ELFTREE what direction to scroll), and then the speed
(1 - 9) digit. A speed of 1 is slowest, and 9 is the fastest.
You can adjust the speed during scrolling by tapping the digit
corresponding to the new setting. To stop scrolling, tap [0].
(The key you tap will be acted on, so if you touch [E], for
example, you will stop scrolling and invoke the editor.
With the mouse pointer on the bottom line of the screen, click on
[123456789] to select or change a scroll speed.
────────────────────────────────────────
FIND TEXT [F]
▀▀▀▀▀▀▀▀▀
You can tell ELFTREE to look for text in the file. Tap [F] or click
on Find and, in the box that appears, type the text to search for.
To begin the search, tap or click on [Enter].
If ELFTREE does not find it, you will be told, otherwise the text
will appear near the top of the screen.
To repeat the search, tap [A] or click on Again.
Note: The above directions assume you want to search from the
current position in the file to the end of the file (called
top-to-bottom searching). If you want to search in the
opposite direction, use [Alt+F] and [Alt+A] instead of
[F] and [A], respectively.
To search for a hexadecimal text string such as 'CD 21'
(ignore the quotes), you would enter CD 21 in the window,
then tap or click on [F10] to begin the search.
────────────────────────────────────────
JUMP AROUND IN FILE [J]
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
You can jump to a specific position in the file being viewed. Tap
[J] or click on Jump, type in the position to jump to, then tap or
click on [Enter]. For example, if you're viewing a 24 million byte
file, you can jump to the 2 millionth character by entering 2M, 2000K
or 2,000,000. The suffix `M' is treated as `Million' and the suffix
`K' is treated as `Thousand'. The first byte in the line of text
starting in the upper left corner of the viewing area is the byte
at this position.
You can also enter the position as a hexadecimal (base 16) number.
For example, if you wish 2M to be treated as 2 Megabytes, enter it
as X2M (the leading `X' indicates that it's in base 16, or `hex').
Of course, you can enter a `hex' number directly, such as FFFF
(which is 65,535 in decimal). You only need to use the leading `X'
for hexadecimal numbers if there are no `hex' numerals in the
position you specify.
────────────────────────────────────────
LINE NUMBERS [L]
▀▀▀▀▀▀▀▀▀▀▀▀
When you select a file to view, ELFTREE initializes counters to keep
track of what line you are currently on, and what position you are
at. If you want to see the line numbers, tap [L] or click on Line
once. If you prefer to see the position, tap [L] or click on Line
to turn the numbers off.
If line numbers are shown and you tap [E] or click on Edit to edit
the file being viewed, ELFTREE can make your editor start at the
current line! This saves you from having to remember what line you
were at, then issue a [Go To Line #] command in your editor.
Note: ELFTREE may not be able to keep track of the line number at
all times; in these cases only your Position in the file
will be given; when ELFTREE can compute your line number
position again, it will show it.
────────────────────────────────────────
ORPHAN [CR] [O]
▀▀▀▀▀▀▀▀▀▀▀
Sometimes, files produced by DOS or other programs contain a carriage
return [CR] (ASCII 13) character without a line-feed character (ASCII
10) to follow it (which makes ELFTREE start a new line). Also, some
word processing programs use the symbol `' (ASCII 11) to denote an
end-of-line character. To make ELFTREE recognize these symbols as
additional end-of-line characters, tap [O] once.
────────────────────────────────────────
REPLACE TEXT [R],[Alt+R]
▀▀▀▀▀▀▀▀▀▀▀▀
When you have found a piece of text while viewing a file, you can
replace it with one of the same length (padded with spaces, if
needed). Here's how to do this:
1. Tap [F] or [Alt+F] (or click on Find) to enter the text to
search for and to find the next occurrence of it.
2. Tap [R] to enter the text to replace it with. If the text is
shorter than what you're looking for, it will be padded
with spaces.
3. Tap [Alt+R] to replace this occurrence of the text; otherwise,
tap [A] or [Alt+A] or click on Again to find the next
occurrence of it.
4. To undo a replacement, tap [U] or [Alt+U] to replace the
occurrence with the text being searched for.
Note: If no Find is in effect, text can be replaced at the position
of the cursor. Just tap [R] to enter the replacement text and
[Alt+R] to apply it.
────────────────────────────────────────
TRANSLATE IBM EBCDIC [I]
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
When viewing a file that is stored in IBM EBCDIC format, you won't
be able to read it easily, since your computer is designed to use
ASCII characters. However, ELFTREE can translate these characters
to ASCII for you - just tap [I] or click on IBM to activate it. To
just convert EBCDIC digits (hex F0 through F9) to ASCII digits, tap
[I] or click on IBM until the EBCDIC 0-9=>ASCII symbol appears.
When activated, you will be able to read the translated text as if
it were stored in ASCII, and you can use ELFTREE's usual viewing
filters on the translated text as well.
If the file being viewed is ASCII text, and you want to convert it
to EBCDIC, just keep tapping [I] or clicking on IBM until the
ASCII<=EBCDIC symbol appears. To just convert ASCII digits (0
through 9) to EBCDIC digits, tap [I] or click on IBM until the
ASCII 0-9=>EBCDIC symbol appears.
When you mark a block (see next section) and append it to a file
with this feature activated, the text appended will be translated
according to the current translation mode in effect. For example,
if EBCDIC=>ASCII is in effect, the appended text will be in ASCII.
────────────────────────────────────────
WORKING WITH BLOCKS [B]
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
While viewing a file, you may wish to:
A. Print a portion of it
B. Append a portion to another file
C. Convert a portion to UPPER case
D. Convert a portion to lower case
E. Convert a portion to Proper case
F. Replace a portion with some character
G. Replace all Nulls (hex 00) in a portion
H. Replace all Control chars in a portion
I. Strip the High bit from all characters in a portion
J. Delete the block of text from the file.
With ELFTREE, this is easy, and requires no programming. Simply
move to the start of the block you wish to use, tap [B] or click on
Block to indicate that you want to define a Block (the block is
marked at your current position in the file, which is the position
of the first character in the file viewing area), then move to the
end of the portion, and tap [B] or click on Block again. A menu of
block commands will appear. Just select the command you want, and
it will be processed immediately, leaving you at the menu in case
you wish to use another command as well, or to repeat a previous
one. When you leave this menu, your block becomes unmarked.
You can use a block as large as the entire file you are viewing.
To quickly select the entire file as a block, tap or click on [F5].
Note: The RightArrow and LeftArrow keys will move you one position
in the corresponding direction. These are especially handy
for marking EXACTLY the block you need.
────────────────────────────────────────
EXTENSION SENSITIVITY
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
You can train ELFTREE to bring up your word processing viewer when
the currently highlighted file has an extension of, say, DOC, or to
load your spreadsheet viewer when the current file's extension starts
with a W. To do this, create an ASCII file with this layout (tap
[Alt+Enter] when viewing to automatically edit the file):
DBF C:\TREE\VIEWDBF.EXE
DOC C:\WP\WPVIEW.EXE -x (parameters can be used)
TXT (ELFTREE uses internal viewer)
W* C:\SS\VSHEET.EXE
ZIP D:\PKZIP -v {Fname} (macro symbols can be used)
Save this file under the name VIEWERS.ELF in the same directory
that the other ELFTREE files are located. The next time you load
ELFTREE, it will be `sensitized' to these extensions. This means,
for example, that when you highlight the file REPORT.DOC and tap
[V], this command is performed:
C:\WP\WPVIEW.EXE -x REPORT.DOC
You can choose up to 40 extensions for ELFTREE to be aware of, and
the extensions can use the DOS wildcards `*' and `?'.
Notes: ELFTREE will allow you to have multiple VIEWERS.ELF files.
When you enter a directory, ELFTREE looks for a VIEWERS.ELF
file and, if it finds one, `resensitizes' itself to what is
in this new one. When you then move on to another directory,
ELFTREE stays sensitive to these extensions.
If the extension of the file does not match any of the
extensions in VIEWERS.ELF, ELFTREE uses its internal viewer.
See the help on DOS Gateway for related information.
PROGRAMMING THE INTERNAL VIEWER
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
As you experiment viewing different files with ELFTREE, you may
notice that you prefer to view some of them one way, and others
another way. For example, files with an .EXE or .COM extension
often are best viewed with the Hex filter active, while normal
text files are best viewed with Wrap off, using the CR/LF filter.
You can make ELFTREE automatically activate several viewing options
by specifying your preferences in this VIEWERS.ELF file. Here are
some examples to show you how to do this. Note the `=' symbol, used
to indicate that what follows applies to the internal viewer.
ASM =H- T8 W M- (Hex off; Tabstop=8; Wrap on)
EXE =H M- (Hex on; Menu inactive)
TXT =H- W- T3 (Hex off; Wrap off; Tabstop=3)
* =D1 T0 M (CR/LF; Tabs off; Menu active)
In general, a symbol followed by a `-' means `turn this off'.
A symbol followed by a space means `turn this on'. Here is a list
of what symbols can be used, and how to use them:
Symbol Modifier Description
====== ======== ======================================
C 0 - 3 Case for text searches.
D 0 - 5 Display filter to use.
H - Hex filter off/on.
I - IBM EBCDIC to ASCII translation off/on.
L - Line numbers shown or not.
O - [CR], recognized as end-of-line or not.
M - Menu active or not.
T 0 - 8 Tabstop distance (0=off, 1-8=on).
W - Wrap long lines off/on.